@wix/sdk-types 1.17.9 → 1.17.11

package/build/browser/index.d.mts

@@ -295,12 +295,24 @@ declare global {
     }
 }
 /**
- * A type used to create concerete types from SDK descriptors in
- * case a contextual client is available.
+ * Creates concrete types from SDK descriptors when a contextual client is
+ * available.
+ *
+ * For a REST descriptor the built (bound) API is intersected with the original
+ * descriptor, matching what `contextualizeRESTModuleV2` returns at runtime — a
+ * value callable as the bound API and still usable as a descriptor. Keeping the
+ * descriptor half lets contextual modules be passed to descriptor-constrained
+ * helpers such as `elevate` from `@wix/sdk/context` (FEDINF-14092).
+ *
+ * The `& T` is scoped to REST descriptors — the only shape codegen wraps in
+ * `MaybeContext` — so `BuildDescriptors` (used by `createClient().use`) is left
+ * unchanged and stays bound-only. The fix lives here rather than in `elevate`,
+ * which is kept strict on purpose (see #941) so it still rejects bound-only
+ * functions that are unsafe through `createRESTModule`.
  */
 type MaybeContext<T extends Descriptors> = globalThis.ContextualClient extends {
     host: Host;
-} ? BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
+} ? T extends RESTFunctionDescriptor ? BuildDescriptors<T, globalThis.ContextualClient['host']> & T : BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
 
 /**
  * Expose fields based on the current exposure toggle.
@@ -442,6 +454,14 @@ declare const SORT_CAPABILITIES: {
     readonly ASC: "ASC";
     readonly DESC: "DESC";
 };
+/**
+ * Origin point for geo-distance sorting on a GEO field.
+ * Results are ordered by distance from this point (ASC = nearest first, DESC = farthest first).
+ */
+type SortingOrigin = {
+    latitude?: number | null;
+    longitude?: number | null;
+};
 /**
  * Helper type to get the fields from a WQL group
  * @template WQLGroup The WQL group type
@@ -459,6 +479,7 @@ type Sorting<Spec extends WQLSpec> = Spec['wql'] extends {
     fieldName?: string;
     order?: SortOrder;
     selectItemsBy?: Record<string, any>[] | null;
+    origin?: SortingOrigin | null;
 } : {
     [WQLGroupIndex in keyof Spec['wql']]: Spec['wql'][WQLGroupIndex] extends {
         fields: readonly string[];
@@ -467,18 +488,22 @@ type Sorting<Spec extends WQLSpec> = Spec['wql'] extends {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: typeof SORT_DIRECTIONS.ASC;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_DIRECTIONS.DESC ? {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: typeof SORT_DIRECTIONS.DESC;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_CAPABILITIES.BOTH ? {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: SortOrder;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_CAPABILITIES.NONE ? {
         fieldName?: never;
         order?: never;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : never : never;
 }[keyof Spec['wql']];
 
@@ -1288,4 +1313,4 @@ interface QueryHelpers<T, S extends QuerySpec, R = QueryRequest<T, S>> {
     Sort: SortFactory<S>;
 }
 
-export { type APIMetadata, type AccessToken, type AccountInfo, type AggregatableFields, type Aggregation, type AggregationBuilder, type AggregationExpression, type AggregationFactory, type AggregationType, type AmbassadorFactory, type AmbassadorFunctionDescriptor, type AmbassadorRequestOptions, type AuthenticationStrategy, type BaseEventMetadata, type BoundAuthenticationStrategy, type BuildAmbassadorFunction, type BuildDescriptors, type BuildEventDefinition, type BuildRESTFunction, type BuildServicePluginDefinition, type CursorPaging, type DateHistogramAggregationBuilder, type Descriptors, EventDefinition, type EventHandler, type EventIdentity, type ExposeFieldsBasedOnToggle, type FieldFilter, type FieldSort, type Filter, type FilterExpression, type FilterFactory, type FilterableFields, type GetNestedType, type HTTPMethod, type Host, type HostModule, type HostModuleAPI, type HttpClient, type HttpResponse, type IdentityProvider, type MaybeContext, type Method, type MigrationOptions, type NestedAggregationBuilder, type NonNullablePaths, type OffsetPaging, type PagingFor, type PublicMetadata, type Query, type QueryBuilder, type QueryHelpers, type QueryRequest, type QuerySpec, type RESTFunctionDescriptor, type RangeAggregationBuilder, type RefreshToken, type RequestContext, type RequestOptions, type RequestOptionsFactory, type RestModuleMeta, SERVICE_PLUGIN_ERROR_TYPE, SORT_CAPABILITIES, SORT_DIRECTIONS, type ScalarAggregationBuilder, type Search, type SearchBuilder, type SearchDetails, type SearchExpression, type SearchHelpers, type SearchParamsBuilder, type SearchParamsFactory, type SearchRequest, type SearchSpec, type SearchableFields, type ServicePluginContract, ServicePluginDefinition, type ServicePluginMethodInput, type ServicePluginMethodMetadata, type SortCapability, type SortExpression, type SortFactory, type SortOrder, type Sorting, type Token, type TokenStorage, type Tokens, type ValueAggregationBuilder, type ValueAggregationSort, type WQL, type WQLSpec };
+export { type APIMetadata, type AccessToken, type AccountInfo, type AggregatableFields, type Aggregation, type AggregationBuilder, type AggregationExpression, type AggregationFactory, type AggregationType, type AmbassadorFactory, type AmbassadorFunctionDescriptor, type AmbassadorRequestOptions, type AuthenticationStrategy, type BaseEventMetadata, type BoundAuthenticationStrategy, type BuildAmbassadorFunction, type BuildDescriptors, type BuildEventDefinition, type BuildRESTFunction, type BuildServicePluginDefinition, type CursorPaging, type DateHistogramAggregationBuilder, type Descriptors, EventDefinition, type EventHandler, type EventIdentity, type ExposeFieldsBasedOnToggle, type FieldFilter, type FieldSort, type Filter, type FilterExpression, type FilterFactory, type FilterableFields, type GetNestedType, type HTTPMethod, type Host, type HostModule, type HostModuleAPI, type HttpClient, type HttpResponse, type IdentityProvider, type MaybeContext, type Method, type MigrationOptions, type NestedAggregationBuilder, type NonNullablePaths, type OffsetPaging, type PagingFor, type PublicMetadata, type Query, type QueryBuilder, type QueryHelpers, type QueryRequest, type QuerySpec, type RESTFunctionDescriptor, type RangeAggregationBuilder, type RefreshToken, type RequestContext, type RequestOptions, type RequestOptionsFactory, type RestModuleMeta, SERVICE_PLUGIN_ERROR_TYPE, SORT_CAPABILITIES, SORT_DIRECTIONS, type ScalarAggregationBuilder, type Search, type SearchBuilder, type SearchDetails, type SearchExpression, type SearchHelpers, type SearchParamsBuilder, type SearchParamsFactory, type SearchRequest, type SearchSpec, type SearchableFields, type ServicePluginContract, ServicePluginDefinition, type ServicePluginMethodInput, type ServicePluginMethodMetadata, type SortCapability, type SortExpression, type SortFactory, type SortOrder, type Sorting, type SortingOrigin, type Token, type TokenStorage, type Tokens, type ValueAggregationBuilder, type ValueAggregationSort, type WQL, type WQLSpec };

package/build/index.d.mts

@@ -295,12 +295,24 @@ declare global {
     }
 }
 /**
- * A type used to create concerete types from SDK descriptors in
- * case a contextual client is available.
+ * Creates concrete types from SDK descriptors when a contextual client is
+ * available.
+ *
+ * For a REST descriptor the built (bound) API is intersected with the original
+ * descriptor, matching what `contextualizeRESTModuleV2` returns at runtime — a
+ * value callable as the bound API and still usable as a descriptor. Keeping the
+ * descriptor half lets contextual modules be passed to descriptor-constrained
+ * helpers such as `elevate` from `@wix/sdk/context` (FEDINF-14092).
+ *
+ * The `& T` is scoped to REST descriptors — the only shape codegen wraps in
+ * `MaybeContext` — so `BuildDescriptors` (used by `createClient().use`) is left
+ * unchanged and stays bound-only. The fix lives here rather than in `elevate`,
+ * which is kept strict on purpose (see #941) so it still rejects bound-only
+ * functions that are unsafe through `createRESTModule`.
  */
 type MaybeContext<T extends Descriptors> = globalThis.ContextualClient extends {
     host: Host;
-} ? BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
+} ? T extends RESTFunctionDescriptor ? BuildDescriptors<T, globalThis.ContextualClient['host']> & T : BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
 
 /**
  * Expose fields based on the current exposure toggle.
@@ -442,6 +454,14 @@ declare const SORT_CAPABILITIES: {
     readonly ASC: "ASC";
     readonly DESC: "DESC";
 };
+/**
+ * Origin point for geo-distance sorting on a GEO field.
+ * Results are ordered by distance from this point (ASC = nearest first, DESC = farthest first).
+ */
+type SortingOrigin = {
+    latitude?: number | null;
+    longitude?: number | null;
+};
 /**
  * Helper type to get the fields from a WQL group
  * @template WQLGroup The WQL group type
@@ -459,6 +479,7 @@ type Sorting<Spec extends WQLSpec> = Spec['wql'] extends {
     fieldName?: string;
     order?: SortOrder;
     selectItemsBy?: Record<string, any>[] | null;
+    origin?: SortingOrigin | null;
 } : {
     [WQLGroupIndex in keyof Spec['wql']]: Spec['wql'][WQLGroupIndex] extends {
         fields: readonly string[];
@@ -467,18 +488,22 @@ type Sorting<Spec extends WQLSpec> = Spec['wql'] extends {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: typeof SORT_DIRECTIONS.ASC;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_DIRECTIONS.DESC ? {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: typeof SORT_DIRECTIONS.DESC;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_CAPABILITIES.BOTH ? {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: SortOrder;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_CAPABILITIES.NONE ? {
         fieldName?: never;
         order?: never;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : never : never;
 }[keyof Spec['wql']];
 
@@ -1288,4 +1313,4 @@ interface QueryHelpers<T, S extends QuerySpec, R = QueryRequest<T, S>> {
     Sort: SortFactory<S>;
 }
 
-export { type APIMetadata, type AccessToken, type AccountInfo, type AggregatableFields, type Aggregation, type AggregationBuilder, type AggregationExpression, type AggregationFactory, type AggregationType, type AmbassadorFactory, type AmbassadorFunctionDescriptor, type AmbassadorRequestOptions, type AuthenticationStrategy, type BaseEventMetadata, type BoundAuthenticationStrategy, type BuildAmbassadorFunction, type BuildDescriptors, type BuildEventDefinition, type BuildRESTFunction, type BuildServicePluginDefinition, type CursorPaging, type DateHistogramAggregationBuilder, type Descriptors, EventDefinition, type EventHandler, type EventIdentity, type ExposeFieldsBasedOnToggle, type FieldFilter, type FieldSort, type Filter, type FilterExpression, type FilterFactory, type FilterableFields, type GetNestedType, type HTTPMethod, type Host, type HostModule, type HostModuleAPI, type HttpClient, type HttpResponse, type IdentityProvider, type MaybeContext, type Method, type MigrationOptions, type NestedAggregationBuilder, type NonNullablePaths, type OffsetPaging, type PagingFor, type PublicMetadata, type Query, type QueryBuilder, type QueryHelpers, type QueryRequest, type QuerySpec, type RESTFunctionDescriptor, type RangeAggregationBuilder, type RefreshToken, type RequestContext, type RequestOptions, type RequestOptionsFactory, type RestModuleMeta, SERVICE_PLUGIN_ERROR_TYPE, SORT_CAPABILITIES, SORT_DIRECTIONS, type ScalarAggregationBuilder, type Search, type SearchBuilder, type SearchDetails, type SearchExpression, type SearchHelpers, type SearchParamsBuilder, type SearchParamsFactory, type SearchRequest, type SearchSpec, type SearchableFields, type ServicePluginContract, ServicePluginDefinition, type ServicePluginMethodInput, type ServicePluginMethodMetadata, type SortCapability, type SortExpression, type SortFactory, type SortOrder, type Sorting, type Token, type TokenStorage, type Tokens, type ValueAggregationBuilder, type ValueAggregationSort, type WQL, type WQLSpec };
+export { type APIMetadata, type AccessToken, type AccountInfo, type AggregatableFields, type Aggregation, type AggregationBuilder, type AggregationExpression, type AggregationFactory, type AggregationType, type AmbassadorFactory, type AmbassadorFunctionDescriptor, type AmbassadorRequestOptions, type AuthenticationStrategy, type BaseEventMetadata, type BoundAuthenticationStrategy, type BuildAmbassadorFunction, type BuildDescriptors, type BuildEventDefinition, type BuildRESTFunction, type BuildServicePluginDefinition, type CursorPaging, type DateHistogramAggregationBuilder, type Descriptors, EventDefinition, type EventHandler, type EventIdentity, type ExposeFieldsBasedOnToggle, type FieldFilter, type FieldSort, type Filter, type FilterExpression, type FilterFactory, type FilterableFields, type GetNestedType, type HTTPMethod, type Host, type HostModule, type HostModuleAPI, type HttpClient, type HttpResponse, type IdentityProvider, type MaybeContext, type Method, type MigrationOptions, type NestedAggregationBuilder, type NonNullablePaths, type OffsetPaging, type PagingFor, type PublicMetadata, type Query, type QueryBuilder, type QueryHelpers, type QueryRequest, type QuerySpec, type RESTFunctionDescriptor, type RangeAggregationBuilder, type RefreshToken, type RequestContext, type RequestOptions, type RequestOptionsFactory, type RestModuleMeta, SERVICE_PLUGIN_ERROR_TYPE, SORT_CAPABILITIES, SORT_DIRECTIONS, type ScalarAggregationBuilder, type Search, type SearchBuilder, type SearchDetails, type SearchExpression, type SearchHelpers, type SearchParamsBuilder, type SearchParamsFactory, type SearchRequest, type SearchSpec, type SearchableFields, type ServicePluginContract, ServicePluginDefinition, type ServicePluginMethodInput, type ServicePluginMethodMetadata, type SortCapability, type SortExpression, type SortFactory, type SortOrder, type Sorting, type SortingOrigin, type Token, type TokenStorage, type Tokens, type ValueAggregationBuilder, type ValueAggregationSort, type WQL, type WQLSpec };

package/build/index.d.ts

@@ -295,12 +295,24 @@ declare global {
     }
 }
 /**
- * A type used to create concerete types from SDK descriptors in
- * case a contextual client is available.
+ * Creates concrete types from SDK descriptors when a contextual client is
+ * available.
+ *
+ * For a REST descriptor the built (bound) API is intersected with the original
+ * descriptor, matching what `contextualizeRESTModuleV2` returns at runtime — a
+ * value callable as the bound API and still usable as a descriptor. Keeping the
+ * descriptor half lets contextual modules be passed to descriptor-constrained
+ * helpers such as `elevate` from `@wix/sdk/context` (FEDINF-14092).
+ *
+ * The `& T` is scoped to REST descriptors — the only shape codegen wraps in
+ * `MaybeContext` — so `BuildDescriptors` (used by `createClient().use`) is left
+ * unchanged and stays bound-only. The fix lives here rather than in `elevate`,
+ * which is kept strict on purpose (see #941) so it still rejects bound-only
+ * functions that are unsafe through `createRESTModule`.
  */
 type MaybeContext<T extends Descriptors> = globalThis.ContextualClient extends {
     host: Host;
-} ? BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
+} ? T extends RESTFunctionDescriptor ? BuildDescriptors<T, globalThis.ContextualClient['host']> & T : BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
 
 /**
  * Expose fields based on the current exposure toggle.
@@ -442,6 +454,14 @@ declare const SORT_CAPABILITIES: {
     readonly ASC: "ASC";
     readonly DESC: "DESC";
 };
+/**
+ * Origin point for geo-distance sorting on a GEO field.
+ * Results are ordered by distance from this point (ASC = nearest first, DESC = farthest first).
+ */
+type SortingOrigin = {
+    latitude?: number | null;
+    longitude?: number | null;
+};
 /**
  * Helper type to get the fields from a WQL group
  * @template WQLGroup The WQL group type
@@ -459,6 +479,7 @@ type Sorting<Spec extends WQLSpec> = Spec['wql'] extends {
     fieldName?: string;
     order?: SortOrder;
     selectItemsBy?: Record<string, any>[] | null;
+    origin?: SortingOrigin | null;
 } : {
     [WQLGroupIndex in keyof Spec['wql']]: Spec['wql'][WQLGroupIndex] extends {
         fields: readonly string[];
@@ -467,18 +488,22 @@ type Sorting<Spec extends WQLSpec> = Spec['wql'] extends {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: typeof SORT_DIRECTIONS.ASC;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_DIRECTIONS.DESC ? {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: typeof SORT_DIRECTIONS.DESC;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_CAPABILITIES.BOTH ? {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: SortOrder;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_CAPABILITIES.NONE ? {
         fieldName?: never;
         order?: never;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : never : never;
 }[keyof Spec['wql']];
 
@@ -1288,4 +1313,4 @@ interface QueryHelpers<T, S extends QuerySpec, R = QueryRequest<T, S>> {
     Sort: SortFactory<S>;
 }
 
-export { type APIMetadata, type AccessToken, type AccountInfo, type AggregatableFields, type Aggregation, type AggregationBuilder, type AggregationExpression, type AggregationFactory, type AggregationType, type AmbassadorFactory, type AmbassadorFunctionDescriptor, type AmbassadorRequestOptions, type AuthenticationStrategy, type BaseEventMetadata, type BoundAuthenticationStrategy, type BuildAmbassadorFunction, type BuildDescriptors, type BuildEventDefinition, type BuildRESTFunction, type BuildServicePluginDefinition, type CursorPaging, type DateHistogramAggregationBuilder, type Descriptors, EventDefinition, type EventHandler, type EventIdentity, type ExposeFieldsBasedOnToggle, type FieldFilter, type FieldSort, type Filter, type FilterExpression, type FilterFactory, type FilterableFields, type GetNestedType, type HTTPMethod, type Host, type HostModule, type HostModuleAPI, type HttpClient, type HttpResponse, type IdentityProvider, type MaybeContext, type Method, type MigrationOptions, type NestedAggregationBuilder, type NonNullablePaths, type OffsetPaging, type PagingFor, type PublicMetadata, type Query, type QueryBuilder, type QueryHelpers, type QueryRequest, type QuerySpec, type RESTFunctionDescriptor, type RangeAggregationBuilder, type RefreshToken, type RequestContext, type RequestOptions, type RequestOptionsFactory, type RestModuleMeta, SERVICE_PLUGIN_ERROR_TYPE, SORT_CAPABILITIES, SORT_DIRECTIONS, type ScalarAggregationBuilder, type Search, type SearchBuilder, type SearchDetails, type SearchExpression, type SearchHelpers, type SearchParamsBuilder, type SearchParamsFactory, type SearchRequest, type SearchSpec, type SearchableFields, type ServicePluginContract, ServicePluginDefinition, type ServicePluginMethodInput, type ServicePluginMethodMetadata, type SortCapability, type SortExpression, type SortFactory, type SortOrder, type Sorting, type Token, type TokenStorage, type Tokens, type ValueAggregationBuilder, type ValueAggregationSort, type WQL, type WQLSpec };
+export { type APIMetadata, type AccessToken, type AccountInfo, type AggregatableFields, type Aggregation, type AggregationBuilder, type AggregationExpression, type AggregationFactory, type AggregationType, type AmbassadorFactory, type AmbassadorFunctionDescriptor, type AmbassadorRequestOptions, type AuthenticationStrategy, type BaseEventMetadata, type BoundAuthenticationStrategy, type BuildAmbassadorFunction, type BuildDescriptors, type BuildEventDefinition, type BuildRESTFunction, type BuildServicePluginDefinition, type CursorPaging, type DateHistogramAggregationBuilder, type Descriptors, EventDefinition, type EventHandler, type EventIdentity, type ExposeFieldsBasedOnToggle, type FieldFilter, type FieldSort, type Filter, type FilterExpression, type FilterFactory, type FilterableFields, type GetNestedType, type HTTPMethod, type Host, type HostModule, type HostModuleAPI, type HttpClient, type HttpResponse, type IdentityProvider, type MaybeContext, type Method, type MigrationOptions, type NestedAggregationBuilder, type NonNullablePaths, type OffsetPaging, type PagingFor, type PublicMetadata, type Query, type QueryBuilder, type QueryHelpers, type QueryRequest, type QuerySpec, type RESTFunctionDescriptor, type RangeAggregationBuilder, type RefreshToken, type RequestContext, type RequestOptions, type RequestOptionsFactory, type RestModuleMeta, SERVICE_PLUGIN_ERROR_TYPE, SORT_CAPABILITIES, SORT_DIRECTIONS, type ScalarAggregationBuilder, type Search, type SearchBuilder, type SearchDetails, type SearchExpression, type SearchHelpers, type SearchParamsBuilder, type SearchParamsFactory, type SearchRequest, type SearchSpec, type SearchableFields, type ServicePluginContract, ServicePluginDefinition, type ServicePluginMethodInput, type ServicePluginMethodMetadata, type SortCapability, type SortExpression, type SortFactory, type SortOrder, type Sorting, type SortingOrigin, type Token, type TokenStorage, type Tokens, type ValueAggregationBuilder, type ValueAggregationSort, type WQL, type WQLSpec };

package/internal/build/browser/index.d.mts

@@ -353,12 +353,24 @@ declare global {
     }
 }
 /**
- * A type used to create concerete types from SDK descriptors in
- * case a contextual client is available.
+ * Creates concrete types from SDK descriptors when a contextual client is
+ * available.
+ *
+ * For a REST descriptor the built (bound) API is intersected with the original
+ * descriptor, matching what `contextualizeRESTModuleV2` returns at runtime — a
+ * value callable as the bound API and still usable as a descriptor. Keeping the
+ * descriptor half lets contextual modules be passed to descriptor-constrained
+ * helpers such as `elevate` from `@wix/sdk/context` (FEDINF-14092).
+ *
+ * The `& T` is scoped to REST descriptors — the only shape codegen wraps in
+ * `MaybeContext` — so `BuildDescriptors` (used by `createClient().use`) is left
+ * unchanged and stays bound-only. The fix lives here rather than in `elevate`,
+ * which is kept strict on purpose (see #941) so it still rejects bound-only
+ * functions that are unsafe through `createRESTModule`.
  */
 type MaybeContext<T extends Descriptors> = globalThis.ContextualClient extends {
     host: Host;
-} ? BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
+} ? T extends RESTFunctionDescriptor ? BuildDescriptors<T, globalThis.ContextualClient['host']> & T : BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
 
 /**
  * Expose fields based on the current exposure toggle.
@@ -500,6 +512,14 @@ declare const SORT_CAPABILITIES: {
     readonly ASC: "ASC";
     readonly DESC: "DESC";
 };
+/**
+ * Origin point for geo-distance sorting on a GEO field.
+ * Results are ordered by distance from this point (ASC = nearest first, DESC = farthest first).
+ */
+type SortingOrigin = {
+    latitude?: number | null;
+    longitude?: number | null;
+};
 /**
  * Helper type to get the fields from a WQL group
  * @template WQLGroup The WQL group type
@@ -517,6 +537,7 @@ type Sorting<Spec extends WQLSpec> = Spec['wql'] extends {
     fieldName?: string;
     order?: SortOrder;
     selectItemsBy?: Record<string, any>[] | null;
+    origin?: SortingOrigin | null;
 } : {
     [WQLGroupIndex in keyof Spec['wql']]: Spec['wql'][WQLGroupIndex] extends {
         fields: readonly string[];
@@ -525,18 +546,22 @@ type Sorting<Spec extends WQLSpec> = Spec['wql'] extends {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: typeof SORT_DIRECTIONS.ASC;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_DIRECTIONS.DESC ? {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: typeof SORT_DIRECTIONS.DESC;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_CAPABILITIES.BOTH ? {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: SortOrder;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_CAPABILITIES.NONE ? {
         fieldName?: never;
         order?: never;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : never : never;
 }[keyof Spec['wql']];
 
@@ -1346,4 +1371,4 @@ interface QueryHelpers<T, S extends QuerySpec, R = QueryRequest<T, S>> {
     Sort: SortFactory<S>;
 }
 
-export { type APIMetadata, type AccessToken, type AccountInfo, type AggregatableFields, type Aggregation, type AggregationBuilder, type AggregationExpression, type AggregationFactory, type AggregationType, type AmbassadorFactory, type AmbassadorFunctionDescriptor, type AmbassadorRequestOptions, type AuthenticationStrategy, type BaseEventMetadata, type BoundAuthenticationStrategy, type BuildAmbassadorFunction, type BuildDescriptors, type BuildEventDefinition, type BuildRESTFunction, type BuildServicePluginDefinition, type CursorPaging, type DateHistogramAggregationBuilder, type Descriptors, EventDefinition, type EventHandler, type EventIdentity, type ExposeFieldsBasedOnToggle, type FieldFilter, type FieldSort, type Filter, type FilterExpression, type FilterFactory, type FilterableFields, type GetNestedType, type HTTPMethod, type Host, type HostModule, type HostModuleAPI, type HttpClient, type HttpResponse, type IdentityProvider, type MaybeContext, type Method, type MigrationOptions, type NestedAggregationBuilder, type NonNullablePaths, type OffsetPaging, type PagingFor, type PublicMetadata, type Query, type QueryBuilder, type QueryHelpers, type QueryRequest, type QuerySpec, type RESTFunctionDescriptor, type RangeAggregationBuilder, type RefreshToken, type RequestContext, type RequestOptions, type RequestOptionsFactory, type RestModuleMeta, SERVICE_PLUGIN_ERROR_TYPE, SORT_CAPABILITIES, SORT_DIRECTIONS, type ScalarAggregationBuilder, type Search, type SearchBuilder, type SearchDetails, type SearchExpression, type SearchHelpers, type SearchParamsBuilder, type SearchParamsFactory, type SearchRequest, type SearchSpec, type SearchableFields, type ServicePluginContract, ServicePluginDefinition, type ServicePluginMethodInput, type ServicePluginMethodMetadata, type SortCapability, type SortExpression, type SortFactory, type SortOrder, type Sorting, type Token, type TokenStorage, type Tokens, type ValueAggregationBuilder, type ValueAggregationSort, type WQL, type WQLSpec };
+export { type APIMetadata, type AccessToken, type AccountInfo, type AggregatableFields, type Aggregation, type AggregationBuilder, type AggregationExpression, type AggregationFactory, type AggregationType, type AmbassadorFactory, type AmbassadorFunctionDescriptor, type AmbassadorRequestOptions, type AuthenticationStrategy, type BaseEventMetadata, type BoundAuthenticationStrategy, type BuildAmbassadorFunction, type BuildDescriptors, type BuildEventDefinition, type BuildRESTFunction, type BuildServicePluginDefinition, type CursorPaging, type DateHistogramAggregationBuilder, type Descriptors, EventDefinition, type EventHandler, type EventIdentity, type ExposeFieldsBasedOnToggle, type FieldFilter, type FieldSort, type Filter, type FilterExpression, type FilterFactory, type FilterableFields, type GetNestedType, type HTTPMethod, type Host, type HostModule, type HostModuleAPI, type HttpClient, type HttpResponse, type IdentityProvider, type MaybeContext, type Method, type MigrationOptions, type NestedAggregationBuilder, type NonNullablePaths, type OffsetPaging, type PagingFor, type PublicMetadata, type Query, type QueryBuilder, type QueryHelpers, type QueryRequest, type QuerySpec, type RESTFunctionDescriptor, type RangeAggregationBuilder, type RefreshToken, type RequestContext, type RequestOptions, type RequestOptionsFactory, type RestModuleMeta, SERVICE_PLUGIN_ERROR_TYPE, SORT_CAPABILITIES, SORT_DIRECTIONS, type ScalarAggregationBuilder, type Search, type SearchBuilder, type SearchDetails, type SearchExpression, type SearchHelpers, type SearchParamsBuilder, type SearchParamsFactory, type SearchRequest, type SearchSpec, type SearchableFields, type ServicePluginContract, ServicePluginDefinition, type ServicePluginMethodInput, type ServicePluginMethodMetadata, type SortCapability, type SortExpression, type SortFactory, type SortOrder, type Sorting, type SortingOrigin, type Token, type TokenStorage, type Tokens, type ValueAggregationBuilder, type ValueAggregationSort, type WQL, type WQLSpec };

package/internal/build/index.d.mts

@@ -353,12 +353,24 @@ declare global {
     }
 }
 /**
- * A type used to create concerete types from SDK descriptors in
- * case a contextual client is available.
+ * Creates concrete types from SDK descriptors when a contextual client is
+ * available.
+ *
+ * For a REST descriptor the built (bound) API is intersected with the original
+ * descriptor, matching what `contextualizeRESTModuleV2` returns at runtime — a
+ * value callable as the bound API and still usable as a descriptor. Keeping the
+ * descriptor half lets contextual modules be passed to descriptor-constrained
+ * helpers such as `elevate` from `@wix/sdk/context` (FEDINF-14092).
+ *
+ * The `& T` is scoped to REST descriptors — the only shape codegen wraps in
+ * `MaybeContext` — so `BuildDescriptors` (used by `createClient().use`) is left
+ * unchanged and stays bound-only. The fix lives here rather than in `elevate`,
+ * which is kept strict on purpose (see #941) so it still rejects bound-only
+ * functions that are unsafe through `createRESTModule`.
  */
 type MaybeContext<T extends Descriptors> = globalThis.ContextualClient extends {
     host: Host;
-} ? BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
+} ? T extends RESTFunctionDescriptor ? BuildDescriptors<T, globalThis.ContextualClient['host']> & T : BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
 
 /**
  * Expose fields based on the current exposure toggle.
@@ -500,6 +512,14 @@ declare const SORT_CAPABILITIES: {
     readonly ASC: "ASC";
     readonly DESC: "DESC";
 };
+/**
+ * Origin point for geo-distance sorting on a GEO field.
+ * Results are ordered by distance from this point (ASC = nearest first, DESC = farthest first).
+ */
+type SortingOrigin = {
+    latitude?: number | null;
+    longitude?: number | null;
+};
 /**
  * Helper type to get the fields from a WQL group
  * @template WQLGroup The WQL group type
@@ -517,6 +537,7 @@ type Sorting<Spec extends WQLSpec> = Spec['wql'] extends {
     fieldName?: string;
     order?: SortOrder;
     selectItemsBy?: Record<string, any>[] | null;
+    origin?: SortingOrigin | null;
 } : {
     [WQLGroupIndex in keyof Spec['wql']]: Spec['wql'][WQLGroupIndex] extends {
         fields: readonly string[];
@@ -525,18 +546,22 @@ type Sorting<Spec extends WQLSpec> = Spec['wql'] extends {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: typeof SORT_DIRECTIONS.ASC;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_DIRECTIONS.DESC ? {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: typeof SORT_DIRECTIONS.DESC;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_CAPABILITIES.BOTH ? {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: SortOrder;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_CAPABILITIES.NONE ? {
         fieldName?: never;
         order?: never;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : never : never;
 }[keyof Spec['wql']];
 
@@ -1346,4 +1371,4 @@ interface QueryHelpers<T, S extends QuerySpec, R = QueryRequest<T, S>> {
     Sort: SortFactory<S>;
 }
 
-export { type APIMetadata, type AccessToken, type AccountInfo, type AggregatableFields, type Aggregation, type AggregationBuilder, type AggregationExpression, type AggregationFactory, type AggregationType, type AmbassadorFactory, type AmbassadorFunctionDescriptor, type AmbassadorRequestOptions, type AuthenticationStrategy, type BaseEventMetadata, type BoundAuthenticationStrategy, type BuildAmbassadorFunction, type BuildDescriptors, type BuildEventDefinition, type BuildRESTFunction, type BuildServicePluginDefinition, type CursorPaging, type DateHistogramAggregationBuilder, type Descriptors, EventDefinition, type EventHandler, type EventIdentity, type ExposeFieldsBasedOnToggle, type FieldFilter, type FieldSort, type Filter, type FilterExpression, type FilterFactory, type FilterableFields, type GetNestedType, type HTTPMethod, type Host, type HostModule, type HostModuleAPI, type HttpClient, type HttpResponse, type IdentityProvider, type MaybeContext, type Method, type MigrationOptions, type NestedAggregationBuilder, type NonNullablePaths, type OffsetPaging, type PagingFor, type PublicMetadata, type Query, type QueryBuilder, type QueryHelpers, type QueryRequest, type QuerySpec, type RESTFunctionDescriptor, type RangeAggregationBuilder, type RefreshToken, type RequestContext, type RequestOptions, type RequestOptionsFactory, type RestModuleMeta, SERVICE_PLUGIN_ERROR_TYPE, SORT_CAPABILITIES, SORT_DIRECTIONS, type ScalarAggregationBuilder, type Search, type SearchBuilder, type SearchDetails, type SearchExpression, type SearchHelpers, type SearchParamsBuilder, type SearchParamsFactory, type SearchRequest, type SearchSpec, type SearchableFields, type ServicePluginContract, ServicePluginDefinition, type ServicePluginMethodInput, type ServicePluginMethodMetadata, type SortCapability, type SortExpression, type SortFactory, type SortOrder, type Sorting, type Token, type TokenStorage, type Tokens, type ValueAggregationBuilder, type ValueAggregationSort, type WQL, type WQLSpec };
+export { type APIMetadata, type AccessToken, type AccountInfo, type AggregatableFields, type Aggregation, type AggregationBuilder, type AggregationExpression, type AggregationFactory, type AggregationType, type AmbassadorFactory, type AmbassadorFunctionDescriptor, type AmbassadorRequestOptions, type AuthenticationStrategy, type BaseEventMetadata, type BoundAuthenticationStrategy, type BuildAmbassadorFunction, type BuildDescriptors, type BuildEventDefinition, type BuildRESTFunction, type BuildServicePluginDefinition, type CursorPaging, type DateHistogramAggregationBuilder, type Descriptors, EventDefinition, type EventHandler, type EventIdentity, type ExposeFieldsBasedOnToggle, type FieldFilter, type FieldSort, type Filter, type FilterExpression, type FilterFactory, type FilterableFields, type GetNestedType, type HTTPMethod, type Host, type HostModule, type HostModuleAPI, type HttpClient, type HttpResponse, type IdentityProvider, type MaybeContext, type Method, type MigrationOptions, type NestedAggregationBuilder, type NonNullablePaths, type OffsetPaging, type PagingFor, type PublicMetadata, type Query, type QueryBuilder, type QueryHelpers, type QueryRequest, type QuerySpec, type RESTFunctionDescriptor, type RangeAggregationBuilder, type RefreshToken, type RequestContext, type RequestOptions, type RequestOptionsFactory, type RestModuleMeta, SERVICE_PLUGIN_ERROR_TYPE, SORT_CAPABILITIES, SORT_DIRECTIONS, type ScalarAggregationBuilder, type Search, type SearchBuilder, type SearchDetails, type SearchExpression, type SearchHelpers, type SearchParamsBuilder, type SearchParamsFactory, type SearchRequest, type SearchSpec, type SearchableFields, type ServicePluginContract, ServicePluginDefinition, type ServicePluginMethodInput, type ServicePluginMethodMetadata, type SortCapability, type SortExpression, type SortFactory, type SortOrder, type Sorting, type SortingOrigin, type Token, type TokenStorage, type Tokens, type ValueAggregationBuilder, type ValueAggregationSort, type WQL, type WQLSpec };

package/internal/build/index.d.ts

@@ -353,12 +353,24 @@ declare global {
     }
 }
 /**
- * A type used to create concerete types from SDK descriptors in
- * case a contextual client is available.
+ * Creates concrete types from SDK descriptors when a contextual client is
+ * available.
+ *
+ * For a REST descriptor the built (bound) API is intersected with the original
+ * descriptor, matching what `contextualizeRESTModuleV2` returns at runtime — a
+ * value callable as the bound API and still usable as a descriptor. Keeping the
+ * descriptor half lets contextual modules be passed to descriptor-constrained
+ * helpers such as `elevate` from `@wix/sdk/context` (FEDINF-14092).
+ *
+ * The `& T` is scoped to REST descriptors — the only shape codegen wraps in
+ * `MaybeContext` — so `BuildDescriptors` (used by `createClient().use`) is left
+ * unchanged and stays bound-only. The fix lives here rather than in `elevate`,
+ * which is kept strict on purpose (see #941) so it still rejects bound-only
+ * functions that are unsafe through `createRESTModule`.
  */
 type MaybeContext<T extends Descriptors> = globalThis.ContextualClient extends {
     host: Host;
-} ? BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
+} ? T extends RESTFunctionDescriptor ? BuildDescriptors<T, globalThis.ContextualClient['host']> & T : BuildDescriptors<T, globalThis.ContextualClient['host']> : T;
 
 /**
  * Expose fields based on the current exposure toggle.
@@ -500,6 +512,14 @@ declare const SORT_CAPABILITIES: {
     readonly ASC: "ASC";
     readonly DESC: "DESC";
 };
+/**
+ * Origin point for geo-distance sorting on a GEO field.
+ * Results are ordered by distance from this point (ASC = nearest first, DESC = farthest first).
+ */
+type SortingOrigin = {
+    latitude?: number | null;
+    longitude?: number | null;
+};
 /**
  * Helper type to get the fields from a WQL group
  * @template WQLGroup The WQL group type
@@ -517,6 +537,7 @@ type Sorting<Spec extends WQLSpec> = Spec['wql'] extends {
     fieldName?: string;
     order?: SortOrder;
     selectItemsBy?: Record<string, any>[] | null;
+    origin?: SortingOrigin | null;
 } : {
     [WQLGroupIndex in keyof Spec['wql']]: Spec['wql'][WQLGroupIndex] extends {
         fields: readonly string[];
@@ -525,18 +546,22 @@ type Sorting<Spec extends WQLSpec> = Spec['wql'] extends {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: typeof SORT_DIRECTIONS.ASC;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_DIRECTIONS.DESC ? {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: typeof SORT_DIRECTIONS.DESC;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_CAPABILITIES.BOTH ? {
         fieldName: WQLFields<Spec['wql'][WQLGroupIndex]>;
         order: SortOrder;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : GroupSortCapability extends typeof SORT_CAPABILITIES.NONE ? {
         fieldName?: never;
         order?: never;
         selectItemsBy?: Record<string, any>[] | null;
+        origin?: SortingOrigin | null;
     } : never : never;
 }[keyof Spec['wql']];
 
@@ -1346,4 +1371,4 @@ interface QueryHelpers<T, S extends QuerySpec, R = QueryRequest<T, S>> {
     Sort: SortFactory<S>;
 }
 
-export { type APIMetadata, type AccessToken, type AccountInfo, type AggregatableFields, type Aggregation, type AggregationBuilder, type AggregationExpression, type AggregationFactory, type AggregationType, type AmbassadorFactory, type AmbassadorFunctionDescriptor, type AmbassadorRequestOptions, type AuthenticationStrategy, type BaseEventMetadata, type BoundAuthenticationStrategy, type BuildAmbassadorFunction, type BuildDescriptors, type BuildEventDefinition, type BuildRESTFunction, type BuildServicePluginDefinition, type CursorPaging, type DateHistogramAggregationBuilder, type Descriptors, EventDefinition, type EventHandler, type EventIdentity, type ExposeFieldsBasedOnToggle, type FieldFilter, type FieldSort, type Filter, type FilterExpression, type FilterFactory, type FilterableFields, type GetNestedType, type HTTPMethod, type Host, type HostModule, type HostModuleAPI, type HttpClient, type HttpResponse, type IdentityProvider, type MaybeContext, type Method, type MigrationOptions, type NestedAggregationBuilder, type NonNullablePaths, type OffsetPaging, type PagingFor, type PublicMetadata, type Query, type QueryBuilder, type QueryHelpers, type QueryRequest, type QuerySpec, type RESTFunctionDescriptor, type RangeAggregationBuilder, type RefreshToken, type RequestContext, type RequestOptions, type RequestOptionsFactory, type RestModuleMeta, SERVICE_PLUGIN_ERROR_TYPE, SORT_CAPABILITIES, SORT_DIRECTIONS, type ScalarAggregationBuilder, type Search, type SearchBuilder, type SearchDetails, type SearchExpression, type SearchHelpers, type SearchParamsBuilder, type SearchParamsFactory, type SearchRequest, type SearchSpec, type SearchableFields, type ServicePluginContract, ServicePluginDefinition, type ServicePluginMethodInput, type ServicePluginMethodMetadata, type SortCapability, type SortExpression, type SortFactory, type SortOrder, type Sorting, type Token, type TokenStorage, type Tokens, type ValueAggregationBuilder, type ValueAggregationSort, type WQL, type WQLSpec };
+export { type APIMetadata, type AccessToken, type AccountInfo, type AggregatableFields, type Aggregation, type AggregationBuilder, type AggregationExpression, type AggregationFactory, type AggregationType, type AmbassadorFactory, type AmbassadorFunctionDescriptor, type AmbassadorRequestOptions, type AuthenticationStrategy, type BaseEventMetadata, type BoundAuthenticationStrategy, type BuildAmbassadorFunction, type BuildDescriptors, type BuildEventDefinition, type BuildRESTFunction, type BuildServicePluginDefinition, type CursorPaging, type DateHistogramAggregationBuilder, type Descriptors, EventDefinition, type EventHandler, type EventIdentity, type ExposeFieldsBasedOnToggle, type FieldFilter, type FieldSort, type Filter, type FilterExpression, type FilterFactory, type FilterableFields, type GetNestedType, type HTTPMethod, type Host, type HostModule, type HostModuleAPI, type HttpClient, type HttpResponse, type IdentityProvider, type MaybeContext, type Method, type MigrationOptions, type NestedAggregationBuilder, type NonNullablePaths, type OffsetPaging, type PagingFor, type PublicMetadata, type Query, type QueryBuilder, type QueryHelpers, type QueryRequest, type QuerySpec, type RESTFunctionDescriptor, type RangeAggregationBuilder, type RefreshToken, type RequestContext, type RequestOptions, type RequestOptionsFactory, type RestModuleMeta, SERVICE_PLUGIN_ERROR_TYPE, SORT_CAPABILITIES, SORT_DIRECTIONS, type ScalarAggregationBuilder, type Search, type SearchBuilder, type SearchDetails, type SearchExpression, type SearchHelpers, type SearchParamsBuilder, type SearchParamsFactory, type SearchRequest, type SearchSpec, type SearchableFields, type ServicePluginContract, ServicePluginDefinition, type ServicePluginMethodInput, type ServicePluginMethodMetadata, type SortCapability, type SortExpression, type SortFactory, type SortOrder, type Sorting, type SortingOrigin, type Token, type TokenStorage, type Tokens, type ValueAggregationBuilder, type ValueAggregationSort, type WQL, type WQLSpec };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/sdk-types",
-  "version": "1.17.9",
+  "version": "1.17.11",
   "author": {
     "name": "Ronny Ringel",
     "email": "ronnyr@wix.com"
@@ -62,5 +62,5 @@
       ]
     }
   },
-  "falconPackageHash": "6ada9c7e15f7a35e78c019a4936d3648472d79e3aa78bd7bcfad7538"
+  "falconPackageHash": "1da777a5d84bf4a8c619897e838f26d5fd1992d2ee20c0665485bce0"
 }