@vansite/ts-sharetribe-flex-sdk 1.0.34 → 2.0.0

package/dist/types/marketplace/images.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Type definitions for Images in the Sharetribe Marketplace API.
+ */
+import { ApiParameter, ExtraParameterType, UUID } from "../sharetribe";
+/**
+ * Available endpoints
+ */
+export type ImagesEndpoints = "upload";
+/**
+ * Standard image variant names
+ */
+export type ImageVariantName = "default" | "landscape-crop" | "landscape-crop2x" | "landscape-crop4x" | "landscape-crop6x" | "scaled-small" | "scaled-medium" | "scaled-large" | "scaled-xlarge" | "square-small" | "square-small2x" | "facebook" | "twitter";
+/**
+ * Image variant object
+ */
+export interface ImageVariant {
+    width: number;
+    height: number;
+    url: string;
+    name: ImageVariantName;
+}
+/**
+ * Image resource
+ */
+export interface Image {
+    id: UUID;
+    type: "image";
+    attributes: {
+        variants: {
+            [K in ImageVariantName]?: ImageVariant;
+        } & {
+            [key: string]: ImageVariant | undefined;
+        };
+    };
+}
+/**
+ * Base request parameters
+ */
+export interface ImagesParameter extends ApiParameter {
+}
+/**
+ * Upload endpoint parameters
+ */
+export interface ImagesUploadParameter extends ImagesParameter {
+    image: File;
+}
+/**
+ * Expand behavior
+ */
+type ExpandResult<EP extends ExtraParameterType | undefined> = EP extends {
+    expand: true;
+} ? Image : EP extends {
+    expand: false;
+} ? Omit<Image, "attributes"> : Omit<Image, "attributes">;
+/**
+ * Response data per endpoint
+ */
+type ResponseData<E extends ImagesEndpoints, EP extends ExtraParameterType | undefined> = E extends "upload" ? ExpandResult<EP> : never;
+/**
+ * Final response type
+ */
+export type ImagesResponse<E extends ImagesEndpoints = "upload", EP extends ExtraParameterType | undefined = undefined> = {
+    data: ResponseData<E, EP>;
+};
+export {};

package/dist/types/marketplace/listings.d.ts

@@ -0,0 +1,169 @@
+/**
+ * @fileoverview Type definitions for Listings in the Sharetribe Marketplace API.
+ */
+import { ApiMeta, ApiParameter, ExtraParameterType, LatLng, LatLngBounds, Money, QueryMeta, QueryPub, Relationship, RelationshipTypeMap, UUID } from "../sharetribe";
+import { AvailabilityPlan } from "./availabilityPlan";
+/**
+ * Public listing states
+ */
+export type ListingState = "published" | "closed" | "draft" | "pendingApproval";
+/**
+ * Availability mode returned in query results
+ */
+export type ListingAvailability = "day-full" | "day-partial" | "time-full" | "time-partial";
+/**
+ * Listing resource
+ */
+export interface Listing<I extends boolean = false> {
+    id: UUID;
+    type: "listing";
+    attributes: {
+        title: string;
+        description: string;
+        price: Money;
+        geolocation: LatLng;
+        state: ListingState;
+        deleted: boolean;
+        createdAt: Date;
+        availabilityPlan: AvailabilityPlan | null;
+        publicData: ListingPublicData & ListingCustomPublicData;
+        metadata: ListingMetadata & ListingCustomMetadata;
+    } & (I extends true ? {
+        privateData: ListingPrivateData & ListingCustomPrivateData;
+    } : {});
+}
+/**
+ * With relationships
+ */
+export interface ListingWithRelationships<I extends boolean = false> extends Listing<I> {
+    relationships: {
+        marketplace: Relationship<false, "marketplace">;
+        author: Relationship<false, "author">;
+        images: Relationship<true, "images">;
+        currentStock?: Relationship<false, "currentStock">;
+    };
+}
+export type ListingResource<R extends boolean, I extends boolean = false> = R extends true ? ListingWithRelationships<I> : Listing<I>;
+/**
+ * Relationship fields
+ */
+export type ListingsRelationshipsFields = "marketplace" | "author" | "author.profileImage" | "author.marketplace" | "author.stripeAccount" | "author.effectivePermissionSet" | "images" | "currentStock";
+/**
+ * Available endpoints
+ */
+export type ListingsEndpoints = "show" | "query" | "create" | "update" | "close" | "open" | "approve";
+/**
+ * Base request parameters
+ */
+export interface ListingsParameter extends ApiParameter {
+    include?: ListingsRelationshipsFields[];
+}
+/**
+ * Endpoint parameters
+ */
+export type ListingsShowParameter = ListingsParameter & {
+    id: UUID | string;
+};
+export interface ListingsQueryParameter extends ListingsParameter {
+    authorId?: UUID | string;
+    ids?: UUID[] | string[];
+    keywords?: string;
+    origin?: LatLng | string;
+    bounds?: LatLngBounds | string;
+    price?: Money | [Money, Money] | string;
+    start?: Date | string;
+    end?: Date | string;
+    seats?: number;
+    availability?: ListingAvailability;
+    minDuration?: number;
+    minStock?: number;
+    sort?: string;
+    [keyof: QueryPub]: string | undefined;
+    [keyof: QueryMeta]: string | undefined;
+}
+export interface ListingsCreateParameter extends ListingsParameter {
+    title: string;
+    authorId: UUID | string;
+    state: ListingState;
+    description?: string;
+    geolocation?: LatLng | string;
+    price?: Money | string;
+    availabilityPlan?: AvailabilityPlan | null;
+    publicData?: ListingPublicData & ListingCustomPublicData;
+    privateData?: ListingPrivateData & ListingCustomPrivateData;
+    metadata?: ListingMetadata & ListingCustomMetadata;
+    images?: UUID[] | string[];
+}
+export type ListingsUpdateParameter = ListingsParameter & {
+    id: UUID | string;
+    title?: string;
+    description?: string;
+    price?: Money | string;
+    availabilityPlan?: AvailabilityPlan | null;
+    publicData?: ListingPublicData & ListingCustomPublicData;
+    privateData?: ListingPrivateData & ListingCustomPrivateData;
+    metadata?: ListingMetadata & ListingCustomMetadata;
+    images?: UUID[] | string[];
+};
+export type ListingsCloseParameter = ListingsParameter & {
+    id: UUID | string;
+};
+export type ListingsOpenParameter = ListingsParameter & {
+    id: UUID | string;
+};
+export type ListingsApproveParameter = ListingsParameter & {
+    id: UUID | string;
+};
+/**
+ * Custom data
+ */
+export interface ListingPublicData {
+    [key: string]: any;
+}
+export interface ListingCustomPublicData extends Record<string, unknown> {
+}
+export interface ListingPrivateData {
+    [key: string]: any;
+}
+export interface ListingCustomPrivateData extends Record<string, unknown> {
+}
+export interface ListingMetadata {
+    [key: string]: any;
+}
+export interface ListingCustomMetadata extends Record<string, unknown> {
+}
+/**
+ * All parameter types
+ */
+type AllListingsParameter = ListingsShowParameter | ListingsQueryParameter | ListingsCreateParameter | ListingsUpdateParameter | ListingsCloseParameter | ListingsOpenParameter | ListingsApproveParameter;
+/**
+ * Include detection — fixes TS2536
+ */
+type HasInclude<P> = P extends {
+    include: infer I extends readonly ListingsRelationshipsFields[];
+} ? I : never;
+type IncludesRelationships<P> = HasInclude<P> extends never ? false : true;
+type IncludedResources<P> = HasInclude<P> extends infer Fields extends ListingsRelationshipsFields[] ? RelationshipTypeMap[Fields[number]][] : never;
+/**
+ * Expand behavior
+ */
+type ExpandResult<T, EP extends ExtraParameterType | undefined> = EP extends {
+    expand: true;
+} ? T : EP extends {
+    expand: false;
+} ? Omit<T, "attributes"> : Omit<T, "attributes">;
+/**
+ * Response data per endpoint
+ */
+type ResponseData<E extends ListingsEndpoints, P extends AllListingsParameter, EP extends ExtraParameterType | undefined, I extends boolean = false> = E extends "query" ? ListingResource<IncludesRelationships<P>, I>[] : E extends "show" | "create" | "update" | "close" | "open" | "approve" ? ExpandResult<ListingResource<IncludesRelationships<P>, I>, EP> : never;
+/**
+ * Final response
+ */
+export type ListingsResponse<E extends ListingsEndpoints, P extends AllListingsParameter, EP extends ExtraParameterType | undefined = undefined, I extends boolean = false> = {
+    data: ResponseData<E, P, EP, I>;
+} & (IncludesRelationships<P> extends true ? {
+    included: IncludedResources<P>;
+} : {}) & (E extends "query" ? {
+    meta: ApiMeta;
+} : {});
+export {};

package/dist/types/marketplace/marketplace.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Type definitions for Marketplace in the Sharetribe Marketplace API.
+ */
+import { UUID } from "../sharetribe";
+/**
+ * Available endpoints
+ */
+export type MarketplaceEndpoints = "show";
+/**
+ * Marketplace resource
+ */
+export interface Marketplace {
+    id: UUID;
+    type: "marketplace";
+    attributes: {
+        name: string;
+        description: string;
+    };
+}
+/**
+ * Response data per endpoint
+ */
+type ResponseData<E extends MarketplaceEndpoints> = E extends "show" ? Marketplace : never;
+/**
+ * Final response type
+ */
+export type MarketplaceResponse<E extends MarketplaceEndpoints = "show"> = {
+    data: ResponseData<E>;
+};
+export {};

package/dist/types/marketplace/messages.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @fileoverview Type definitions for Messages in the Sharetribe Marketplace API.
+ */
+import { ApiMeta, ApiParameter, ExtraParameterType, Relationship, RelationshipTypeMap, UUID } from "../sharetribe";
+/**
+ * Available endpoints
+ */
+export type MessagesEndpoints = "query" | "send";
+/**
+ * Relationship fields that can be included
+ */
+export type MessagesRelationshipsFields = "sender" | "sender.profileImage" | "sender.marketplace" | "transaction" | "transaction.marketplace" | "transaction.listing" | "transaction.provider" | "transaction.customer" | "transaction.booking" | "transaction.stockReservation" | "transaction.reviews" | "transaction.messages";
+/**
+ * Message resource
+ */
+export interface Message {
+    id: UUID;
+    type: "message";
+    attributes: {
+        content: string;
+        createdAt: Date;
+    };
+}
+/**
+ * With relationships
+ */
+export interface MessageWithRelationships extends Message {
+    relationships: {
+        sender: Relationship<false, "sender">;
+        transaction: Relationship<false, "transaction">;
+    };
+}
+export type MessageResource<R extends boolean> = R extends true ? MessageWithRelationships : Message;
+/**
+ * Base request parameters
+ */
+export interface MessagesParameter extends ApiParameter {
+    include?: MessagesRelationshipsFields[];
+}
+/**
+ * Query messages
+ */
+export interface MessagesQueryParameter extends MessagesParameter {
+    transactionId: UUID | string;
+}
+/**
+ * Send a message
+ */
+export interface MessagesSendParameter extends MessagesParameter {
+    transactionId: UUID | string;
+    content: string;
+}
+/**
+ * All parameter types
+ */
+type AllMessagesParameter = MessagesQueryParameter | MessagesSendParameter;
+/**
+ * Include detection — fixes TS2536
+ */
+type HasInclude<P> = P extends {
+    include: infer I extends readonly MessagesRelationshipsFields[];
+} ? I : never;
+type IncludesRelationships<P> = HasInclude<P> extends never ? false : true;
+type IncludedResources<P> = HasInclude<P> extends infer Fields extends MessagesRelationshipsFields[] ? RelationshipTypeMap[Fields[number]][] : never;
+/**
+ * Expand behavior
+ */
+type ExpandResult<T, EP extends ExtraParameterType | undefined> = EP extends {
+    expand: true;
+} ? T : EP extends {
+    expand: false;
+} ? Omit<T, "attributes"> : Omit<T, "attributes">;
+/**
+ * Response data per endpoint
+ */
+type ResponseData<E extends MessagesEndpoints, P extends AllMessagesParameter, EP extends ExtraParameterType | undefined> = E extends "query" ? MessageResource<IncludesRelationships<P>>[] : E extends "send" ? ExpandResult<MessageResource<IncludesRelationships<P>>, EP> : never;
+/**
+ * Final response type
+ */
+export type MessagesResponse<E extends MessagesEndpoints, P extends AllMessagesParameter, EP extends ExtraParameterType | undefined = undefined> = {
+    data: ResponseData<E, P, EP>;
+} & (IncludesRelationships<P> extends true ? {
+    included: IncludedResources<P>;
+} : {}) & (E extends "query" ? {
+    meta: ApiMeta;
+} : {});
+export {};

package/dist/types/marketplace/ownListings.d.ts

@@ -0,0 +1,155 @@
+/**
+ * @fileoverview Type definitions for Own Listings in the Sharetribe Marketplace API.
+ */
+import { ApiMeta, ApiParameter, ExtraParameterType, LatLng, Money, Relationship, RelationshipTypeMap, UUID } from "../sharetribe";
+import { AvailabilityPlan } from "./availabilityPlan";
+/**
+ * Listing states
+ */
+export type OwnListingState = "draft" | "pendingApproval" | "published" | "closed";
+/**
+ * Available endpoints
+ */
+export type OwnListingsEndpoints = "show" | "query" | "create" | "createDraft" | "update" | "publishDraft" | "discardDraft" | "close" | "open" | "addImage";
+/**
+ * Relationship fields
+ */
+export type OwnListingsRelationshipsFields = "marketplace" | "author.profileImage" | "author.marketplace" | "author.stripeAccount" | "author.effectivePermissionSet" | "images" | "currentStock";
+/**
+ * Own Listing resource
+ */
+export interface OwnListing {
+    id: UUID;
+    type: "ownListing";
+    attributes: {
+        title: string;
+        description: string;
+        price: Money;
+        geolocation: LatLng;
+        state: OwnListingState;
+        deleted: boolean;
+        createdAt: Date;
+        availabilityPlan: AvailabilityPlan | null;
+        publicData: OwnListingPublicData & OwnListingCustomPublicData;
+        privateData: OwnListingPrivateData & OwnListingCustomPrivateData;
+        metadata: OwnListingMetadata & OwnListingCustomMetadata;
+    };
+}
+/**
+ * With relationships
+ */
+export interface OwnListingWithRelationships extends OwnListing {
+    relationships: {
+        marketplace: Relationship<false, "marketplace">;
+        author: Relationship<false, "author">;
+        images: Relationship<true, "images">;
+        currentStock?: Relationship<false, "currentStock">;
+    };
+}
+export type OwnListingResource<R extends boolean> = R extends true ? OwnListingWithRelationships : OwnListing;
+/**
+ * Base request parameters
+ */
+export interface OwnListingsParameter extends ApiParameter {
+    include?: OwnListingsRelationshipsFields[];
+}
+/**
+ * Endpoint-specific parameters
+ */
+export type OwnListingsShowParameter = OwnListingsParameter & {
+    id: UUID | string;
+};
+export type OwnListingsQueryParameter = OwnListingsParameter;
+export interface OwnListingsCreateParameter extends OwnListingsParameter {
+    title: string;
+    description?: string;
+    price?: Money;
+    geolocation?: LatLng;
+    availabilityPlan?: AvailabilityPlan | null;
+    publicData?: OwnListingPublicData & OwnListingCustomPublicData;
+    privateData?: OwnListingPrivateData & OwnListingCustomPrivateData;
+    metadata?: OwnListingMetadata & OwnListingCustomMetadata;
+    images?: string[];
+}
+export type OwnListingsCreateDraftParameter = OwnListingsCreateParameter;
+export interface OwnListingsUpdateParameter extends OwnListingsParameter {
+    id: UUID | string;
+    title?: string;
+    description?: string;
+    price?: Money;
+    geolocation?: LatLng;
+    availabilityPlan?: AvailabilityPlan | null;
+    publicData?: OwnListingPublicData & OwnListingCustomPublicData;
+    privateData?: OwnListingPrivateData & OwnListingCustomPrivateData;
+    metadata?: OwnListingMetadata & OwnListingCustomMetadata;
+    images?: string[];
+}
+export type OwnListingsPublishDraftParameter = OwnListingsParameter & {
+    id: UUID | string;
+};
+export type OwnListingsDiscardDraftParameter = OwnListingsParameter & {
+    id: UUID | string;
+};
+export type OwnListingsCloseParameter = OwnListingsParameter & {
+    id: UUID | string;
+};
+export type OwnListingsOpenParameter = OwnListingsParameter & {
+    id: UUID | string;
+};
+export type OwnListingsAddImageParameter = OwnListingsParameter & {
+    id: UUID | string;
+    imageId: UUID | string;
+};
+/**
+ * Custom data
+ */
+export interface OwnListingPublicData {
+    [key: string]: any;
+}
+export interface OwnListingCustomPublicData extends Record<string, unknown> {
+}
+export interface OwnListingPrivateData {
+    [key: string]: any;
+}
+export interface OwnListingCustomPrivateData extends Record<string, unknown> {
+}
+export interface OwnListingMetadata {
+    [key: string]: any;
+}
+export interface OwnListingCustomMetadata extends Record<string, unknown> {
+}
+/**
+ * All parameter types
+ */
+type AllOwnListingsParameter = OwnListingsShowParameter | OwnListingsQueryParameter | OwnListingsCreateParameter | OwnListingsCreateDraftParameter | OwnListingsUpdateParameter | OwnListingsPublishDraftParameter | OwnListingsDiscardDraftParameter | OwnListingsCloseParameter | OwnListingsOpenParameter | OwnListingsAddImageParameter;
+/**
+ * Include detection — fixes TS2536
+ */
+type HasInclude<P> = P extends {
+    include: infer I extends readonly OwnListingsRelationshipsFields[];
+} ? I : never;
+type IncludesRelationships<P> = HasInclude<P> extends never ? false : true;
+type IncludedResources<P> = HasInclude<P> extends infer Fields extends OwnListingsRelationshipsFields[] ? RelationshipTypeMap[Fields[number]][] : never;
+/**
+ * Expand behavior
+ */
+type ExpandResult<T, EP extends ExtraParameterType | undefined> = EP extends {
+    expand: true;
+} ? T : EP extends {
+    expand: false;
+} ? Omit<T, "attributes"> : Omit<T, "attributes">;
+/**
+ * Response data per endpoint
+ */
+type ResponseData<E extends OwnListingsEndpoints, P extends AllOwnListingsParameter, EP extends ExtraParameterType | undefined> = E extends "show" | "create" | "createDraft" | "update" | "publishDraft" | "close" | "open" | "addImage" ? ExpandResult<OwnListingResource<IncludesRelationships<P>>, EP> : E extends "query" ? OwnListingResource<IncludesRelationships<P>>[] : E extends "discardDraft" ? Pick<OwnListing, "id" | "type"> : never;
+/**
+ * Final response
+ */
+export type OwnListingsResponse<E extends OwnListingsEndpoints, P extends AllOwnListingsParameter, EP extends ExtraParameterType | undefined = undefined> = {
+    data: ResponseData<E, P, EP>;
+} & (IncludesRelationships<P> extends true ? {
+    included: IncludedResources<P>;
+} : {}) & (E extends "query" ? {
+    meta: ApiMeta;
+} : {});
+export {};

package/dist/types/marketplace/passwordReset.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Type definitions for Password Reset operations in the Sharetribe Marketplace API.
+ */
+import { ApiParameter, ExtraParameterType, UUID } from "../sharetribe";
+/**
+ * Available endpoints
+ */
+export type PasswordResetEndpoints = "request" | "reset";
+/**
+ * Password reset resource (usually empty or minimal)
+ */
+export interface PasswordReset {
+    id: UUID;
+    type: "passwordReset";
+    attributes?: Record<string, never>;
+}
+/**
+ * Base request parameters
+ */
+export interface PasswordResetParameter extends ApiParameter {
+}
+/**
+ * Request password reset (send email)
+ */
+export interface PasswordResetRequestParameter extends PasswordResetParameter {
+    email: string;
+}
+/**
+ * Complete password reset using token
+ */
+export interface PasswordResetResetParameter extends PasswordResetParameter {
+    email: string;
+    passwordResetToken: string;
+    newPassword: string;
+}
+/**
+ * Expand behavior
+ */
+type ExpandResult<EP extends ExtraParameterType | undefined> = EP extends {
+    expand: true;
+} ? PasswordReset : EP extends {
+    expand: false;
+} ? Omit<PasswordReset, "attributes"> : Omit<PasswordReset, "attributes">;
+/**
+ * Response data per endpoint
+ */
+type ResponseData<E extends PasswordResetEndpoints, EP extends ExtraParameterType | undefined> = E extends "request" | "reset" ? ExpandResult<EP> : never;
+/**
+ * Final response type
+ */
+export type PasswordResetResponse<E extends PasswordResetEndpoints, EP extends ExtraParameterType | undefined = undefined> = {
+    data: ResponseData<E, EP>;
+};
+export {};

package/dist/types/marketplace/processTransitions.d.ts

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview Type definitions for Process Transitions in the Sharetribe Marketplace API.
+ */
+import { ApiParameter, UUID } from "../sharetribe";
+/**
+ * Available endpoints
+ */
+export type ProcessTransitionsEndpoints = "query";
+/**
+ * Actors that can trigger a transition
+ */
+type Actor = "customer" | "provider" | "operator" | "system";
+/**
+ * Supported parameter types in transition requests
+ */
+type ParamType = "uuid" | "string" | "integer" | "timestamp" | "boolean" | "object" | "money" | ["lineItem"];
+/**
+ * Process Transition resource
+ */
+export interface ProcessTransition {
+    id: UUID;
+    type: "processTransition";
+    attributes: {
+        name: string;
+        actor: Actor[];
+        actions: string[];
+        params: {
+            req: Record<string, ParamType>;
+            opt: Record<string, ParamType> | null;
+        };
+    };
+}
+/**
+ * Base request parameters
+ */
+export interface ProcessTransitionsParameter extends ApiParameter {
+}
+/**
+ * Query parameters
+ */
+export interface ProcessTransitionsQueryParameter extends ProcessTransitionsParameter {
+    processAlias?: string;
+    lastTransition?: string;
+    transactionId?: UUID | string;
+}
+/**
+ * Response data per endpoint
+ */
+type ResponseData<E extends ProcessTransitionsEndpoints> = E extends "query" ? ProcessTransition[] : never;
+/**
+ * Final response type
+ */
+export type ProcessTransitionsResponse<E extends ProcessTransitionsEndpoints = "query"> = {
+    data: ResponseData<E>;
+};
+export {};