🚨 Announcing Vendure v2 Beta

Enums

AdjustmentType

  • PROMOTION
  • DISTRIBUTED_ORDER_PROMOTION
  • OTHER

AssetType

  • IMAGE
  • VIDEO
  • BINARY

CurrencyCode

ISO 4217 currency code

  • // United Arab Emirates dirham
  • AED
  • // Afghan afghani
  • AFN
  • // Albanian lek
  • ALL
  • // Armenian dram
  • AMD
  • // Netherlands Antillean guilder
  • ANG
  • // Angolan kwanza
  • AOA
  • // Argentine peso
  • ARS
  • // Australian dollar
  • AUD
  • // Aruban florin
  • AWG
  • // Azerbaijani manat
  • AZN
  • // Bosnia and Herzegovina convertible mark
  • BAM
  • // Barbados dollar
  • BBD
  • // Bangladeshi taka
  • BDT
  • // Bulgarian lev
  • BGN
  • // Bahraini dinar
  • BHD
  • // Burundian franc
  • BIF
  • // Bermudian dollar
  • BMD
  • // Brunei dollar
  • BND
  • // Boliviano
  • BOB
  • // Brazilian real
  • BRL
  • // Bahamian dollar
  • BSD
  • // Bhutanese ngultrum
  • BTN
  • // Botswana pula
  • BWP
  • // Belarusian ruble
  • BYN
  • // Belize dollar
  • BZD
  • // Canadian dollar
  • CAD
  • // Congolese franc
  • CDF
  • // Swiss franc
  • CHF
  • // Chilean peso
  • CLP
  • // Renminbi (Chinese) yuan
  • CNY
  • // Colombian peso
  • COP
  • // Costa Rican colon
  • CRC
  • // Cuban convertible peso
  • CUC
  • // Cuban peso
  • CUP
  • // Cape Verde escudo
  • CVE
  • // Czech koruna
  • CZK
  • // Djiboutian franc
  • DJF
  • // Danish krone
  • DKK
  • // Dominican peso
  • DOP
  • // Algerian dinar
  • DZD
  • // Egyptian pound
  • EGP
  • // Eritrean nakfa
  • ERN
  • // Ethiopian birr
  • ETB
  • // Euro
  • EUR
  • // Fiji dollar
  • FJD
  • // Falkland Islands pound
  • FKP
  • // Pound sterling
  • GBP
  • // Georgian lari
  • GEL
  • // Ghanaian cedi
  • GHS
  • // Gibraltar pound
  • GIP
  • // Gambian dalasi
  • GMD
  • // Guinean franc
  • GNF
  • // Guatemalan quetzal
  • GTQ
  • // Guyanese dollar
  • GYD
  • // Hong Kong dollar
  • HKD
  • // Honduran lempira
  • HNL
  • // Croatian kuna
  • HRK
  • // Haitian gourde
  • HTG
  • // Hungarian forint
  • HUF
  • // Indonesian rupiah
  • IDR
  • // Israeli new shekel
  • ILS
  • // Indian rupee
  • INR
  • // Iraqi dinar
  • IQD
  • // Iranian rial
  • IRR
  • // Icelandic króna
  • ISK
  • // Jamaican dollar
  • JMD
  • // Jordanian dinar
  • JOD
  • // Japanese yen
  • JPY
  • // Kenyan shilling
  • KES
  • // Kyrgyzstani som
  • KGS
  • // Cambodian riel
  • KHR
  • // Comoro franc
  • KMF
  • // North Korean won
  • KPW
  • // South Korean won
  • KRW
  • // Kuwaiti dinar
  • KWD
  • // Cayman Islands dollar
  • KYD
  • // Kazakhstani tenge
  • KZT
  • // Lao kip
  • LAK
  • // Lebanese pound
  • LBP
  • // Sri Lankan rupee
  • LKR
  • // Liberian dollar
  • LRD
  • // Lesotho loti
  • LSL
  • // Libyan dinar
  • LYD
  • // Moroccan dirham
  • MAD
  • // Moldovan leu
  • MDL
  • // Malagasy ariary
  • MGA
  • // Macedonian denar
  • MKD
  • // Myanmar kyat
  • MMK
  • // Mongolian tögrög
  • MNT
  • // Macanese pataca
  • MOP
  • // Mauritanian ouguiya
  • MRU
  • // Mauritian rupee
  • MUR
  • // Maldivian rufiyaa
  • MVR
  • // Malawian kwacha
  • MWK
  • // Mexican peso
  • MXN
  • // Malaysian ringgit
  • MYR
  • // Mozambican metical
  • MZN
  • // Namibian dollar
  • NAD
  • // Nigerian naira
  • NGN
  • // Nicaraguan córdoba
  • NIO
  • // Norwegian krone
  • NOK
  • // Nepalese rupee
  • NPR
  • // New Zealand dollar
  • NZD
  • // Omani rial
  • OMR
  • // Panamanian balboa
  • PAB
  • // Peruvian sol
  • PEN
  • // Papua New Guinean kina
  • PGK
  • // Philippine peso
  • PHP
  • // Pakistani rupee
  • PKR
  • // Polish złoty
  • PLN
  • // Paraguayan guaraní
  • PYG
  • // Qatari riyal
  • QAR
  • // Romanian leu
  • RON
  • // Serbian dinar
  • RSD
  • // Russian ruble
  • RUB
  • // Rwandan franc
  • RWF
  • // Saudi riyal
  • SAR
  • // Solomon Islands dollar
  • SBD
  • // Seychelles rupee
  • SCR
  • // Sudanese pound
  • SDG
  • // Swedish krona/kronor
  • SEK
  • // Singapore dollar
  • SGD
  • // Saint Helena pound
  • SHP
  • // Sierra Leonean leone
  • SLL
  • // Somali shilling
  • SOS
  • // Surinamese dollar
  • SRD
  • // South Sudanese pound
  • SSP
  • // São Tomé and Príncipe dobra
  • STN
  • // Salvadoran colón
  • SVC
  • // Syrian pound
  • SYP
  • // Swazi lilangeni
  • SZL
  • // Thai baht
  • THB
  • // Tajikistani somoni
  • TJS
  • // Turkmenistan manat
  • TMT
  • // Tunisian dinar
  • TND
  • // Tongan paʻanga
  • TOP
  • // Turkish lira
  • TRY
  • // Trinidad and Tobago dollar
  • TTD
  • // New Taiwan dollar
  • TWD
  • // Tanzanian shilling
  • TZS
  • // Ukrainian hryvnia
  • UAH
  • // Ugandan shilling
  • UGX
  • // United States dollar
  • USD
  • // Uruguayan peso
  • UYU
  • // Uzbekistan som
  • UZS
  • // Venezuelan bolívar soberano
  • VES
  • // Vietnamese đồng
  • VND
  • // Vanuatu vatu
  • VUV
  • // Samoan tala
  • WST
  • // CFA franc BEAC
  • XAF
  • // East Caribbean dollar
  • XCD
  • // CFA franc BCEAO
  • XOF
  • // CFP franc (franc Pacifique)
  • XPF
  • // Yemeni rial
  • YER
  • // South African rand
  • ZAR
  • // Zambian kwacha
  • ZMW
  • // Zimbabwean dollar
  • ZWL

DeletionResult

  • // The entity was successfully deleted
  • DELETED
  • // Deletion did not take place, reason given in message
  • NOT_DELETED

ErrorCode

  • UNKNOWN_ERROR
  • MIME_TYPE_ERROR
  • LANGUAGE_NOT_AVAILABLE_ERROR
  • FACET_IN_USE_ERROR
  • CHANNEL_DEFAULT_LANGUAGE_ERROR
  • SETTLE_PAYMENT_ERROR
  • CANCEL_PAYMENT_ERROR
  • EMPTY_ORDER_LINE_SELECTION_ERROR
  • ITEMS_ALREADY_FULFILLED_ERROR
  • INVALID_FULFILLMENT_HANDLER_ERROR
  • CREATE_FULFILLMENT_ERROR
  • INSUFFICIENT_STOCK_ON_HAND_ERROR
  • MULTIPLE_ORDER_ERROR
  • CANCEL_ACTIVE_ORDER_ERROR
  • PAYMENT_ORDER_MISMATCH_ERROR
  • REFUND_ORDER_STATE_ERROR
  • NOTHING_TO_REFUND_ERROR
  • ALREADY_REFUNDED_ERROR
  • QUANTITY_TOO_GREAT_ERROR
  • REFUND_STATE_TRANSITION_ERROR
  • PAYMENT_STATE_TRANSITION_ERROR
  • FULFILLMENT_STATE_TRANSITION_ERROR
  • ORDER_MODIFICATION_STATE_ERROR
  • NO_CHANGES_SPECIFIED_ERROR
  • PAYMENT_METHOD_MISSING_ERROR
  • REFUND_PAYMENT_ID_MISSING_ERROR
  • MANUAL_PAYMENT_STATE_ERROR
  • PRODUCT_OPTION_IN_USE_ERROR
  • MISSING_CONDITIONS_ERROR
  • NATIVE_AUTH_STRATEGY_ERROR
  • INVALID_CREDENTIALS_ERROR
  • ORDER_STATE_TRANSITION_ERROR
  • EMAIL_ADDRESS_CONFLICT_ERROR
  • ORDER_LIMIT_ERROR
  • NEGATIVE_QUANTITY_ERROR
  • INSUFFICIENT_STOCK_ERROR
  • COUPON_CODE_INVALID_ERROR
  • COUPON_CODE_EXPIRED_ERROR
  • COUPON_CODE_LIMIT_ERROR
  • ORDER_MODIFICATION_ERROR
  • INELIGIBLE_SHIPPING_METHOD_ERROR
  • NO_ACTIVE_ORDER_ERROR

GlobalFlag

  • TRUE
  • FALSE
  • INHERIT

HistoryEntryType

  • CUSTOMER_REGISTERED
  • CUSTOMER_VERIFIED
  • CUSTOMER_DETAIL_UPDATED
  • CUSTOMER_ADDED_TO_GROUP
  • CUSTOMER_REMOVED_FROM_GROUP
  • CUSTOMER_ADDRESS_CREATED
  • CUSTOMER_ADDRESS_UPDATED
  • CUSTOMER_ADDRESS_DELETED
  • CUSTOMER_PASSWORD_UPDATED
  • CUSTOMER_PASSWORD_RESET_REQUESTED
  • CUSTOMER_PASSWORD_RESET_VERIFIED
  • CUSTOMER_EMAIL_UPDATE_REQUESTED
  • CUSTOMER_EMAIL_UPDATE_VERIFIED
  • CUSTOMER_NOTE
  • ORDER_STATE_TRANSITION
  • ORDER_PAYMENT_TRANSITION
  • ORDER_FULFILLMENT
  • ORDER_CANCELLATION
  • ORDER_REFUND_TRANSITION
  • ORDER_FULFILLMENT_TRANSITION
  • ORDER_NOTE
  • ORDER_COUPON_APPLIED
  • ORDER_COUPON_REMOVED
  • ORDER_MODIFIED

JobState

The state of a Job in the JobQueue

  • PENDING
  • RUNNING
  • COMPLETED
  • RETRYING
  • FAILED
  • CANCELLED

LanguageCode

Languages in the form of a ISO 639-1 language code with optional region or script modifier (e.g. de_AT). The selection available is based on the Unicode CLDR summary list and includes the major spoken languages of the world and any widely-used variants.

  • // Afrikaans
  • af
  • // Akan
  • ak
  • // Albanian
  • sq
  • // Amharic
  • am
  • // Arabic
  • ar
  • // Armenian
  • hy
  • // Assamese
  • as
  • // Azerbaijani
  • az
  • // Bambara
  • bm
  • // Bangla
  • bn
  • // Basque
  • eu
  • // Belarusian
  • be
  • // Bosnian
  • bs
  • // Breton
  • br
  • // Bulgarian
  • bg
  • // Burmese
  • my
  • // Catalan
  • ca
  • // Chechen
  • ce
  • // Chinese
  • zh
  • // Simplified Chinese
  • zh_Hans
  • // Traditional Chinese
  • zh_Hant
  • // Church Slavic
  • cu
  • // Cornish
  • kw
  • // Corsican
  • co
  • // Croatian
  • hr
  • // Czech
  • cs
  • // Danish
  • da
  • // Dutch
  • nl
  • // Flemish
  • nl_BE
  • // Dzongkha
  • dz
  • // English
  • en
  • // Australian English
  • en_AU
  • // Canadian English
  • en_CA
  • // British English
  • en_GB
  • // American English
  • en_US
  • // Esperanto
  • eo
  • // Estonian
  • et
  • // Ewe
  • ee
  • // Faroese
  • fo
  • // Finnish
  • fi
  • // French
  • fr
  • // Canadian French
  • fr_CA
  • // Swiss French
  • fr_CH
  • // Fulah
  • ff
  • // Galician
  • gl
  • // Ganda
  • lg
  • // Georgian
  • ka
  • // German
  • de
  • // Austrian German
  • de_AT
  • // Swiss High German
  • de_CH
  • // Greek
  • el
  • // Gujarati
  • gu
  • // Haitian Creole
  • ht
  • // Hausa
  • ha
  • // Hebrew
  • he
  • // Hindi
  • hi
  • // Hungarian
  • hu
  • // Icelandic
  • is
  • // Igbo
  • ig
  • // Indonesian
  • id
  • // Interlingua
  • ia
  • // Irish
  • ga
  • // Italian
  • it
  • // Japanese
  • ja
  • // Javanese
  • jv
  • // Kalaallisut
  • kl
  • // Kannada
  • kn
  • // Kashmiri
  • ks
  • // Kazakh
  • kk
  • // Khmer
  • km
  • // Kikuyu
  • ki
  • // Kinyarwanda
  • rw
  • // Korean
  • ko
  • // Kurdish
  • ku
  • // Kyrgyz
  • ky
  • // Lao
  • lo
  • // Latin
  • la
  • // Latvian
  • lv
  • // Lingala
  • ln
  • // Lithuanian
  • lt
  • // Luba-Katanga
  • lu
  • // Luxembourgish
  • lb
  • // Macedonian
  • mk
  • // Malagasy
  • mg
  • // Malay
  • ms
  • // Malayalam
  • ml
  • // Maltese
  • mt
  • // Manx
  • gv
  • // Maori
  • mi
  • // Marathi
  • mr
  • // Mongolian
  • mn
  • // Nepali
  • ne
  • // North Ndebele
  • nd
  • // Northern Sami
  • se
  • // Norwegian Bokmål
  • nb
  • // Norwegian Nynorsk
  • nn
  • // Nyanja
  • ny
  • // Odia
  • or
  • // Oromo
  • om
  • // Ossetic
  • os
  • // Pashto
  • ps
  • // Persian
  • fa
  • // Dari
  • fa_AF
  • // Polish
  • pl
  • // Portuguese
  • pt
  • // Brazilian Portuguese
  • pt_BR
  • // European Portuguese
  • pt_PT
  • // Punjabi
  • pa
  • // Quechua
  • qu
  • // Romanian
  • ro
  • // Moldavian
  • ro_MD
  • // Romansh
  • rm
  • // Rundi
  • rn
  • // Russian
  • ru
  • // Samoan
  • sm
  • // Sango
  • sg
  • // Sanskrit
  • sa
  • // Scottish Gaelic
  • gd
  • // Serbian
  • sr
  • // Shona
  • sn
  • // Sichuan Yi
  • ii
  • // Sindhi
  • sd
  • // Sinhala
  • si
  • // Slovak
  • sk
  • // Slovenian
  • sl
  • // Somali
  • so
  • // Southern Sotho
  • st
  • // Spanish
  • es
  • // European Spanish
  • es_ES
  • // Mexican Spanish
  • es_MX
  • // Sundanese
  • su
  • // Swahili
  • sw
  • // Congo Swahili
  • sw_CD
  • // Swedish
  • sv
  • // Tajik
  • tg
  • // Tamil
  • ta
  • // Tatar
  • tt
  • // Telugu
  • te
  • // Thai
  • th
  • // Tibetan
  • bo
  • // Tigrinya
  • ti
  • // Tongan
  • to
  • // Turkish
  • tr
  • // Turkmen
  • tk
  • // Ukrainian
  • uk
  • // Urdu
  • ur
  • // Uyghur
  • ug
  • // Uzbek
  • uz
  • // Vietnamese
  • vi
  • // Volapük
  • vo
  • // Welsh
  • cy
  • // Western Frisian
  • fy
  • // Wolof
  • wo
  • // Xhosa
  • xh
  • // Yiddish
  • yi
  • // Yoruba
  • yo
  • // Zulu
  • zu

LogicalOperator

  • AND
  • OR

Permission

Permissions for administrators and customers. Used to control access to GraphQL resolvers via the {@link Allow} decorator.

Understanding Permission.Owner

Permission.Owner is a special permission which is used in some Vendure resolvers to indicate that that resolver should only be accessible to the “owner” of that resource.

For example, the Shop API activeCustomer query resolver should only return the Customer object for the “owner” of that Customer, i.e. based on the activeUserId of the current session. As a result, the resolver code looks like this:

@example

\@Query()
\@Allow(Permission.Owner)
async activeCustomer(\@Ctx() ctx: RequestContext): Promise<Customer | undefined> {
  const userId = ctx.activeUserId;
  if (userId) {
    return this.customerService.findOneByUserId(ctx, userId);
  }
}

Here we can see that the “ownership” must be enforced by custom logic inside the resolver. Since “ownership” cannot be defined generally nor statically encoded at build-time, any resolvers using Permission.Owner must include logic to enforce that only the owner of the resource has access. If not, then it is the equivalent of using Permission.Public.

  • // Authenticated means simply that the user is logged in
  • Authenticated
  • // SuperAdmin has unrestricted access to all operations
  • SuperAdmin
  • // Owner means the user owns this entity, e.g. a Customer’s own Order
  • Owner
  • // Public means any unauthenticated user may perform the operation
  • Public
  • // Grants permission to update GlobalSettings
  • UpdateGlobalSettings
  • // Grants permission to create Products, Facets, Assets, Collections
  • CreateCatalog
  • // Grants permission to read Products, Facets, Assets, Collections
  • ReadCatalog
  • // Grants permission to update Products, Facets, Assets, Collections
  • UpdateCatalog
  • // Grants permission to delete Products, Facets, Assets, Collections
  • DeleteCatalog
  • // Grants permission to create PaymentMethods, ShippingMethods, TaxCategories, TaxRates, Zones, Countries, System & GlobalSettings
  • CreateSettings
  • // Grants permission to read PaymentMethods, ShippingMethods, TaxCategories, TaxRates, Zones, Countries, System & GlobalSettings
  • ReadSettings
  • // Grants permission to update PaymentMethods, ShippingMethods, TaxCategories, TaxRates, Zones, Countries, System & GlobalSettings
  • UpdateSettings
  • // Grants permission to delete PaymentMethods, ShippingMethods, TaxCategories, TaxRates, Zones, Countries, System & GlobalSettings
  • DeleteSettings
  • // Grants permission to create Administrator
  • CreateAdministrator
  • // Grants permission to read Administrator
  • ReadAdministrator
  • // Grants permission to update Administrator
  • UpdateAdministrator
  • // Grants permission to delete Administrator
  • DeleteAdministrator
  • // Grants permission to create Asset
  • CreateAsset
  • // Grants permission to read Asset
  • ReadAsset
  • // Grants permission to update Asset
  • UpdateAsset
  • // Grants permission to delete Asset
  • DeleteAsset
  • // Grants permission to create Channel
  • CreateChannel
  • // Grants permission to read Channel
  • ReadChannel
  • // Grants permission to update Channel
  • UpdateChannel
  • // Grants permission to delete Channel
  • DeleteChannel
  • // Grants permission to create Collection
  • CreateCollection
  • // Grants permission to read Collection
  • ReadCollection
  • // Grants permission to update Collection
  • UpdateCollection
  • // Grants permission to delete Collection
  • DeleteCollection
  • // Grants permission to create Country
  • CreateCountry
  • // Grants permission to read Country
  • ReadCountry
  • // Grants permission to update Country
  • UpdateCountry
  • // Grants permission to delete Country
  • DeleteCountry
  • // Grants permission to create Customer
  • CreateCustomer
  • // Grants permission to read Customer
  • ReadCustomer
  • // Grants permission to update Customer
  • UpdateCustomer
  • // Grants permission to delete Customer
  • DeleteCustomer
  • // Grants permission to create CustomerGroup
  • CreateCustomerGroup
  • // Grants permission to read CustomerGroup
  • ReadCustomerGroup
  • // Grants permission to update CustomerGroup
  • UpdateCustomerGroup
  • // Grants permission to delete CustomerGroup
  • DeleteCustomerGroup
  • // Grants permission to create Facet
  • CreateFacet
  • // Grants permission to read Facet
  • ReadFacet
  • // Grants permission to update Facet
  • UpdateFacet
  • // Grants permission to delete Facet
  • DeleteFacet
  • // Grants permission to create Order
  • CreateOrder
  • // Grants permission to read Order
  • ReadOrder
  • // Grants permission to update Order
  • UpdateOrder
  • // Grants permission to delete Order
  • DeleteOrder
  • // Grants permission to create PaymentMethod
  • CreatePaymentMethod
  • // Grants permission to read PaymentMethod
  • ReadPaymentMethod
  • // Grants permission to update PaymentMethod
  • UpdatePaymentMethod
  • // Grants permission to delete PaymentMethod
  • DeletePaymentMethod
  • // Grants permission to create Product
  • CreateProduct
  • // Grants permission to read Product
  • ReadProduct
  • // Grants permission to update Product
  • UpdateProduct
  • // Grants permission to delete Product
  • DeleteProduct
  • // Grants permission to create Promotion
  • CreatePromotion
  • // Grants permission to read Promotion
  • ReadPromotion
  • // Grants permission to update Promotion
  • UpdatePromotion
  • // Grants permission to delete Promotion
  • DeletePromotion
  • // Grants permission to create ShippingMethod
  • CreateShippingMethod
  • // Grants permission to read ShippingMethod
  • ReadShippingMethod
  • // Grants permission to update ShippingMethod
  • UpdateShippingMethod
  • // Grants permission to delete ShippingMethod
  • DeleteShippingMethod
  • // Grants permission to create Tag
  • CreateTag
  • // Grants permission to read Tag
  • ReadTag
  • // Grants permission to update Tag
  • UpdateTag
  • // Grants permission to delete Tag
  • DeleteTag
  • // Grants permission to create TaxCategory
  • CreateTaxCategory
  • // Grants permission to read TaxCategory
  • ReadTaxCategory
  • // Grants permission to update TaxCategory
  • UpdateTaxCategory
  • // Grants permission to delete TaxCategory
  • DeleteTaxCategory
  • // Grants permission to create TaxRate
  • CreateTaxRate
  • // Grants permission to read TaxRate
  • ReadTaxRate
  • // Grants permission to update TaxRate
  • UpdateTaxRate
  • // Grants permission to delete TaxRate
  • DeleteTaxRate
  • // Grants permission to create System
  • CreateSystem
  • // Grants permission to read System
  • ReadSystem
  • // Grants permission to update System
  • UpdateSystem
  • // Grants permission to delete System
  • DeleteSystem
  • // Grants permission to create Zone
  • CreateZone
  • // Grants permission to read Zone
  • ReadZone
  • // Grants permission to update Zone
  • UpdateZone
  • // Grants permission to delete Zone
  • DeleteZone

SortOrder

  • ASC
  • DESC

StockMovementType

  • ADJUSTMENT
  • ALLOCATION
  • RELEASE
  • SALE
  • CANCELLATION
  • RETURN