@skalpgg/sdk 1.4.0 → 1.6.0

package/README.md

@@ -43,11 +43,12 @@ Create the key on the API keys page of your dashboard. Each key is bound to one
 | --- | --- |
 | `checkout.create({ productId, quantity?, customerEmail?, metadata?, couponCode?, returnUrl?, customFields? })` | `checkout:write` |
 | `checkout.get(id)` | `checkout:read` |
-| `orders.list({ status?, productId?, email?, createdAfter?, createdBefore?, updatedSince?, limit?, offset? })` | `orders:read` |
+| `orders.list({ status?, productId?, email?, identifier?, createdAfter?, createdBefore?, updatedSince?, limit?, offset? })` | `orders:read` |
 | `orders.get(id)` | `orders:read` |
 | `orders.cancel(id)` | `orders:write` |
+| `orders.redeliver(id)` | `orders:write` |
 | `orders.replace(id, { serialIds?, values?, reason? })` | `orders:write` |
-| `products.list({ status? })` | `products:read` |
+| `products.list({ status?, limit?, offset? })` | `products:read` |
 | `products.get(idOrSlug)` | `products:read` |
 | `products.create({ name, price, fulfillmentType?, submit?, ... })` | `products:write` |
 | `products.update(idOrSlug, { price?, status?: 'DRAFT' \| 'ARCHIVED', ... })` | `products:write` |
@@ -108,6 +109,8 @@ await skalp.products.submit(product.id)
 
 A product starts as a `DRAFT`. `submit` sends it to review, and the review sets `ACTIVE` or `REJECTED`; read the product to see which. `update` accepts only `DRAFT` and `ARCHIVED` as a `status`, and `archive` takes a product off sale without deleting anything. Pass `null` to `update` to clear `comparePrice`, `storeCategoryId`, `dynamicUrl` or `licenseDurationDays`.
 
+`price` is in your store currency, and buyers in Poland, the euro area, the US and Brazil pay it converted at the day's rate. To charge a round local price instead, pass `prices: [{ currency: 'PLN', price: 79 }]`: up to three currencies other than the store one, from 5 to 999999 each, not on coin packs. The list replaces the old one, and `[]` removes them.
+
 `addSerials` splits `text` on new lines unless you pass `delimiter` (`'comma'`, `'semicolon'` or any other string). A key the product already has is counted in `skipped` and not added again. `listSerials` returns the plain key values, which is why it needs `products:write`.
 
 ## Orders and customers
@@ -117,11 +120,19 @@ const { data: orders } = await skalp.orders.list({ status: 'COMPLETED', updatedS
 
 await skalp.orders.cancel(order.id)
 
+const { data: mine } = await skalp.orders.list({ identifier: ['steam:110000112345679', 'discord:123456789012345678'] })
+
+await skalp.orders.redeliver(order.id)
+
 const { replacements } = await skalp.orders.replace(order.id, { reason: 'Key does not activate' })
 ```
 
 `cancel` works only on a `PENDING` order and returns it as `CANCELED`. `replace` swaps the delivered keys of a completed order: with no `serialIds` it replaces every key, and with no `values` it draws the new ones from stock (`values` is required for keys that come from your server). The replacement keys come back in `replacements[].value`. `orders.get` also returns `serialsReplaced`, the `replacements` history and `serials`: the id, status, `deliveredAt` and `replacedById` of every delivered or replaced key (never its value), which are the ids `serialIds` expects.
 
+`identifier` keeps the orders of one player (up to 10 values of up to 200 characters; a longer list or value is a 400). A value is a game identity: `steam:<hex>`, a SteamID64, any `kind:value` such as `discord:123456789012345678` or `license:abc...`, or a bare value. It matches orders whose buyer or gift recipient signed in with that Steam account, or where a checkout custom field answer equals the value (case and a leading `kind:` prefix on either side are ignored). It combines with the other filters.
+
+`redeliver` takes the order's id or its number (`SKP-XXXX-XXXX-XXXX`) and sends a completed order that was not delivered again: a `FAILED` delivery goes back to `PENDING` and the `order.paid` and `purchase.completed` webhooks are sent again to the store's game server, which delivers it as a normal purchase. It returns the order as `orders.get` does. It answers 400 when the order is not `COMPLETED`, is already `DELIVERED`, is a gift nobody has claimed yet, or never had a licence issued, and 404 when the order is not in the key's store.
+
 `updatedSince` lists oldest change first, so you can page through it and keep the last `updatedAt` as your cursor; without it, newest orders come first. Amounts are in major units (`19.5`).
 
 Coupons take `validFrom`, `validTo` as an ISO string or a `Date`; `coupons.update` accepts `null` to clear `validTo`, `maxUses`, `minPurchaseAmount` and `description`.

package/dist/cjs/index.d.ts

@@ -1,6 +1,6 @@
 import type { AccessRule, AddAccessRuleParams, AddSerialsParams, AddSerialsResult, AppealFeedbackParams, ChangeSubscriptionPlanParams, CheckoutSession, CheckoutSessionStatus, CoinCheckout, CoinCheckoutStatus, Coupon, CreateCheckoutParams, CreateCoinCheckoutParams, CreateCouponParams, CreateCustomerParams, CreateProductGroupParams, CreateProductParams, CreateStoreCategoryParams, CreateSubscriptionCheckoutParams, CreateUsageChargeParams, Customer, CustomerDetails, CustomerList, Deleted, Feedback, FeedbackList, HeartbeatParams, Invoice, LicenseKeyInfo, LicenseValidation, LicenseVerification, ListAccessRulesParams, ListCustomersParams, ListFeedbackParams, ListOrdersParams, ListProductsParams, ListQueriesParams, ListSerialsParams, ListSubscriptionsParams, Order, OrderKeysReplaced, OrderList, Product, ProductGroup, ProductStock, ReplaceOrderKeysParams, ReplyParams, SerialList, SkalpEvent, StoreCategory, StoreCategoryWithCount, Subscription, SubscriptionCheckout, SubscriptionCheckoutStatus, SubscriptionList, SupportQueryDetails, SupportQueryList, ResetLicenseDevicesParams, UpdateCouponParams, UpdateCustomerParams, UpdateProductGroupParams, UpdateProductParams, UpdateStoreCategoryParams, UsageCharge, ValidateLicenseParams, VerifyLicenseParams } from './types.js';
 export type * from './types.js';
-export declare const VERSION = "1.4.0";
+export declare const VERSION = "1.6.0";
 export interface SkalpOptions {
     apiKey?: string;
     webhookSecret?: string;
@@ -36,13 +36,14 @@ export declare class Skalp {
         get: (id: string) => Promise<CheckoutSessionStatus>;
     };
     readonly orders: {
-        list: ({ status, productId, email, createdAfter, createdBefore, updatedSince, limit, offset }?: ListOrdersParams) => Promise<OrderList>;
+        list: ({ status, productId, email, identifier, createdAfter, createdBefore, updatedSince, limit, offset }?: ListOrdersParams) => Promise<OrderList>;
         get: (id: string) => Promise<Order>;
         cancel: (id: string) => Promise<Order>;
+        redeliver: (id: string) => Promise<Order>;
         replace: (id: string, { serialIds, values, reason }?: ReplaceOrderKeysParams) => Promise<OrderKeysReplaced>;
     };
     readonly products: {
-        list: ({ status }?: ListProductsParams) => Promise<Product[]>;
+        list: ({ status, limit, offset }?: ListProductsParams) => Promise<Array<Product>>;
         get: (idOrSlug: string) => Promise<Product>;
         create: (params: CreateProductParams) => Promise<Product>;
         update: (idOrSlug: string, params: UpdateProductParams) => Promise<Product>;

package/dist/cjs/index.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Skalp = exports.SkalpSignatureError = exports.SkalpConnectionError = exports.SkalpError = exports.VERSION = void 0;
-exports.VERSION = '1.4.0';
+exports.VERSION = '1.6.0';
 const SIGNATURE_HEADER = 'skalp-signature';
 const SIGNATURE_TOLERANCE_SECONDS = 300;
+const PRODUCT_PAGE = 100;
 const USER_AGENT = `skalp-node/${exports.VERSION}`;
 const DEFAULT_TIMEOUT_MS = 30_000;
 const MAX_RETRY_WAIT_SECONDS = 10;
@@ -51,6 +52,7 @@ const PRODUCT_FIELDS = [
     'comparePrice',
     'category',
     'categoryId',
+    'game',
     'storeCategoryId',
     'tags',
     'images',
@@ -61,6 +63,24 @@ const PRODUCT_FIELDS = [
     'dynamicUrl',
     'licenseDeviceLimit',
     'licenseDurationDays',
+    'deliveryType',
+    'deliveryPayload',
+    'revokePayload',
+    'coinConfig',
+    'visibility',
+    'sortPriority',
+    'deliveryNote',
+    'termsOfService',
+    'warrantyDays',
+    'warrantyText',
+    'blockVpn',
+    'maxRiskScore',
+    'customFields',
+    'minQuantity',
+    'maxQuantity',
+    'volumeDiscounts',
+    'upsells',
+    'prices',
 ];
 const COUPON_FIELDS = [
     'discountType',
@@ -109,11 +129,12 @@ class Skalp {
         get: (id) => this.#request('GET', `/v1/checkout/sessions/${segment(id)}`),
     };
     orders = {
-        list: ({ status, productId, email, createdAfter, createdBefore, updatedSince, limit, offset } = {}) => this.#request('GET', '/v1/orders', {
+        list: ({ status, productId, email, identifier, createdAfter, createdBefore, updatedSince, limit, offset } = {}) => this.#request('GET', '/v1/orders', {
             query: {
                 status,
                 productId,
                 email,
+                identifier,
                 createdAfter: optionalDate(createdAfter),
                 createdBefore: optionalDate(createdBefore),
                 updatedSince: optionalDate(updatedSince),
@@ -123,12 +144,27 @@ class Skalp {
         }),
         get: (id) => this.#request('GET', `/v1/orders/${segment(id)}`),
         cancel: (id) => this.#request('POST', `/v1/orders/${segment(id)}/cancel`),
+        redeliver: (id) => this.#request('POST', `/v1/orders/${segment(id)}/redeliver`),
         replace: (id, { serialIds, values, reason } = {}) => this.#request('POST', `/v1/orders/${segment(id)}/replacement`, {
             body: { serialIds, values, reason },
         }),
     };
     products = {
-        list: ({ status } = {}) => this.#request('GET', '/v1/products', { query: { status } }),
+        list: async ({ status, limit, offset } = {}) => {
+            if (limit !== undefined || offset !== undefined) {
+                return (await this.#send('GET', '/v1/products', { query: { status, limit, offset } })).data;
+            }
+            const products = [];
+            for (;;) {
+                const page = await this.#send('GET', '/v1/products', {
+                    query: { status, limit: PRODUCT_PAGE, offset: products.length },
+                });
+                products.push(...page.data);
+                const total = Number(page.headers.get('x-total-count'));
+                if (page.data.length < PRODUCT_PAGE || products.length >= total)
+                    return products;
+            }
+        },
         get: (idOrSlug) => this.#request('GET', `/v1/products/${segment(idOrSlug)}`),
         create: (params) => this.#request('POST', '/v1/products', {
             body: pick(params, [...PRODUCT_FIELDS, 'productType', 'submit']),
@@ -294,13 +330,19 @@ class Skalp {
         const hmac = await crypto.subtle.importKey('raw', encoder.encode(key), { name: 'HMAC', hash: 'SHA-256' }, false, ['verify']);
         return (await crypto.subtle.verify('HMAC', hmac, parsed.signature, signed)) ? undefined : 'invalid';
     }
-    async #request(method, path, { body, query, auth = true } = {}) {
+    async #request(method, path, options = {}) {
+        return (await this.#send(method, path, options)).data;
+    }
+    async #send(method, path, { body, query, auth = true } = {}) {
         if (auth && !this.#apiKey) {
             throw new Error('Skalp: missing API key. Pass it to new Skalp(apiKey) or set SKALP_API_KEY.');
         }
         const url = new URL(this.#baseUrl + path);
         for (const [name, value] of Object.entries(query ?? {})) {
-            if (value !== undefined && value !== null)
+            if (Array.isArray(value))
+                for (const item of value)
+                    url.searchParams.append(name, String(item));
+            else if (value !== undefined && value !== null)
                 url.searchParams.set(name, String(value));
         }
         const headers = { accept: 'application/json', 'user-agent': USER_AGENT };
@@ -339,7 +381,7 @@ class Skalp {
             }
             if (!res.ok)
                 throw toError(res.status, data);
-            return data;
+            return { data: data, headers: res.headers };
         }
     }
 }

package/dist/cjs/types.d.ts

@@ -2,6 +2,7 @@ export type Currency = 'EUR' | 'USD' | 'PLN' | (string & {});
 export type FulfillmentType = 'FILE' | 'SERIAL' | 'GAME' | 'SERVICE' | 'DYNAMIC' | 'LICENSE';
 export type ProductStatus = 'DRAFT' | 'PENDING_REVIEW' | 'PROCESSING' | 'PROCESSING_FAILED' | 'ACTIVE' | 'REJECTED' | 'ARCHIVED';
 export type ProductType = 'ONE_TIME' | 'RECURRING' | 'COINS';
+export type Game = 'fivem' | 'minecraft' | 'rust';
 export type BillingInterval = 'WEEK' | 'MONTH' | 'YEAR';
 export type OrderStatus = 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'REFUNDED' | 'DISPUTED' | 'CANCELED';
 export type PaymentProvider = 'STRIPE' | 'NOWPAYMENTS' | 'PAYPAL';
@@ -91,6 +92,7 @@ export interface ListOrdersParams {
     status?: OrderStatus;
     productId?: string;
     email?: string;
+    identifier?: string | Array<string>;
     createdAfter?: string | Date;
     createdBefore?: string | Date;
     updatedSince?: string | Date;
@@ -176,6 +178,10 @@ export type DeliveryType = 'COMMAND' | 'SQL';
  * ON_HOLD is listed but not buyable, PRIVATE sells only through the API.
  */
 export type ProductVisibility = 'PUBLIC' | 'UNLISTED' | 'ON_HOLD' | 'PRIVATE';
+export interface ProductPrice {
+    currency: Currency;
+    price: number;
+}
 export interface Product {
     id: string;
     storeId: string;
@@ -186,12 +192,15 @@ export interface Product {
     price: number;
     comparePrice: number | null;
     currency: Currency;
+    /** Round prices the seller set in other currencies. A buyer whose local currency is listed pays it exactly. */
+    prices: Array<ProductPrice>;
     status: ProductStatus;
     rejectionReason: string | null;
     productType: ProductType;
     billingInterval: BillingInterval | null;
     trialPeriodDays: number;
     fulfillmentType: FulfillmentType | null;
+    game: Game | null;
     category: string;
     categoryId: string | null;
     storeCategoryId: string | null;
@@ -205,6 +214,13 @@ export interface Product {
     deliveryType: DeliveryType | null;
     /** Server stores: what the game server runs after payment. */
     deliveryPayload: string | null;
+    revokePayload: string | null;
+    coinConfig: CoinConfig | null;
+    pendingChanges: {
+        submittedAt: string;
+        changes: Partial<Record<ReviewedProductField, unknown>>;
+    } | null;
+    pendingChangesRejection: string | null;
     visibility: ProductVisibility;
     /** Higher comes first on the store page. */
     sortPriority: number;
@@ -232,8 +248,24 @@ export interface Product {
     createdAt: string;
     updatedAt: string;
 }
+export interface CoinBonusTier {
+    thresholdCoins: number;
+    bonusPercent: number;
+}
+export interface CoinConfig {
+    unitPriceCents: number;
+    minQty: number;
+    maxQty: number;
+    step: number;
+    currency: string;
+    bonusTiers: Array<CoinBonusTier>;
+}
+export type CoinConfigInput = Omit<CoinConfig, 'currency'>;
+export type ReviewedProductField = 'name' | 'shortDescription' | 'description' | 'images' | 'videoUrl' | 'features' | 'requirements' | 'customFields' | 'deliveryNote' | 'termsOfService' | 'warrantyText' | 'deliveryType' | 'deliveryPayload' | 'revokePayload';
 export interface ListProductsParams {
     status?: ProductStatus | 'all';
+    limit?: number;
+    offset?: number;
 }
 interface ProductFields {
     slug?: string;
@@ -241,6 +273,7 @@ interface ProductFields {
     shortDescription?: string;
     category?: string;
     categoryId?: string;
+    game?: Game | null;
     storeCategoryId?: string | null;
     tags?: Array<string>;
     images?: Array<string>;
@@ -255,6 +288,8 @@ interface ProductFields {
     deliveryType?: DeliveryType;
     /** Required for a server store; needs a placeholder such as {steamhex}. */
     deliveryPayload?: string;
+    revokePayload?: string;
+    coinConfig?: CoinConfigInput;
     visibility?: ProductVisibility;
     sortPriority?: number;
     /** null or an empty string clears it. */
@@ -274,12 +309,14 @@ interface ProductFields {
     volumeDiscounts?: Array<VolumeDiscount> | null;
     /** Up to 3 one-time products of the store; the list replaces the old one, [] or null removes them all. */
     upsells?: Array<ProductUpsellInput> | null;
+    /** Up to 3 currencies other than the store currency, not for coin packs; the list replaces the old one, [] or null removes them all. */
+    prices?: Array<ProductPrice> | null;
 }
 export interface CreateProductParams extends ProductFields {
     name: string;
     price: number;
     comparePrice?: number;
-    productType?: 'ONE_TIME' | 'RECURRING';
+    productType?: 'ONE_TIME' | 'RECURRING' | 'COINS';
     submit?: boolean;
 }
 export interface UpdateProductParams extends ProductFields {
@@ -799,6 +836,16 @@ export interface OrderRefundedData {
     granted?: boolean;
     fullRefund: boolean;
     licenses: Array<WebhookLicense>;
+    revocations: Array<Revocation>;
+}
+export interface Revocation {
+    productId: string;
+    productSlug: string;
+    productName: string;
+    deliveryKey: string;
+    delivered: boolean;
+    deliveryType: DeliveryType;
+    revokeCommand: string;
 }
 export interface OrderDisputedData {
     orderId: string;
@@ -851,6 +898,7 @@ export interface ProductEventData {
     price: number;
     fulfillmentType: FulfillmentType | null;
     productType: ProductType;
+    game: Game | null;
 }
 export interface ProductStockData {
     productId: string;
@@ -914,6 +962,7 @@ export type SkalpEvent = Envelope<'order.created' | 'order.updated' | 'order.can
 }> | Envelope<'subscription.canceled', SubscriptionEventData & {
     endedAt: string | null;
     cancelReason: 'requested' | 'payment_failure' | 'dispute' | 'stripe';
+    revokeCommand?: string;
 }> | Envelope<'subscription.refunded', SubscriptionEventData & {
     invoiceId: string;
     amountRefunded: number;

package/dist/esm/index.d.ts

@@ -1,6 +1,6 @@
 import type { AccessRule, AddAccessRuleParams, AddSerialsParams, AddSerialsResult, AppealFeedbackParams, ChangeSubscriptionPlanParams, CheckoutSession, CheckoutSessionStatus, CoinCheckout, CoinCheckoutStatus, Coupon, CreateCheckoutParams, CreateCoinCheckoutParams, CreateCouponParams, CreateCustomerParams, CreateProductGroupParams, CreateProductParams, CreateStoreCategoryParams, CreateSubscriptionCheckoutParams, CreateUsageChargeParams, Customer, CustomerDetails, CustomerList, Deleted, Feedback, FeedbackList, HeartbeatParams, Invoice, LicenseKeyInfo, LicenseValidation, LicenseVerification, ListAccessRulesParams, ListCustomersParams, ListFeedbackParams, ListOrdersParams, ListProductsParams, ListQueriesParams, ListSerialsParams, ListSubscriptionsParams, Order, OrderKeysReplaced, OrderList, Product, ProductGroup, ProductStock, ReplaceOrderKeysParams, ReplyParams, SerialList, SkalpEvent, StoreCategory, StoreCategoryWithCount, Subscription, SubscriptionCheckout, SubscriptionCheckoutStatus, SubscriptionList, SupportQueryDetails, SupportQueryList, ResetLicenseDevicesParams, UpdateCouponParams, UpdateCustomerParams, UpdateProductGroupParams, UpdateProductParams, UpdateStoreCategoryParams, UsageCharge, ValidateLicenseParams, VerifyLicenseParams } from './types.js';
 export type * from './types.js';
-export declare const VERSION = "1.4.0";
+export declare const VERSION = "1.6.0";
 export interface SkalpOptions {
     apiKey?: string;
     webhookSecret?: string;
@@ -36,13 +36,14 @@ export declare class Skalp {
         get: (id: string) => Promise<CheckoutSessionStatus>;
     };
     readonly orders: {
-        list: ({ status, productId, email, createdAfter, createdBefore, updatedSince, limit, offset }?: ListOrdersParams) => Promise<OrderList>;
+        list: ({ status, productId, email, identifier, createdAfter, createdBefore, updatedSince, limit, offset }?: ListOrdersParams) => Promise<OrderList>;
         get: (id: string) => Promise<Order>;
         cancel: (id: string) => Promise<Order>;
+        redeliver: (id: string) => Promise<Order>;
         replace: (id: string, { serialIds, values, reason }?: ReplaceOrderKeysParams) => Promise<OrderKeysReplaced>;
     };
     readonly products: {
-        list: ({ status }?: ListProductsParams) => Promise<Product[]>;
+        list: ({ status, limit, offset }?: ListProductsParams) => Promise<Array<Product>>;
         get: (idOrSlug: string) => Promise<Product>;
         create: (params: CreateProductParams) => Promise<Product>;
         update: (idOrSlug: string, params: UpdateProductParams) => Promise<Product>;

package/dist/esm/index.js

@@ -1,6 +1,7 @@
-export const VERSION = '1.4.0';
+export const VERSION = '1.6.0';
 const SIGNATURE_HEADER = 'skalp-signature';
 const SIGNATURE_TOLERANCE_SECONDS = 300;
+const PRODUCT_PAGE = 100;
 const USER_AGENT = `skalp-node/${VERSION}`;
 const DEFAULT_TIMEOUT_MS = 30_000;
 const MAX_RETRY_WAIT_SECONDS = 10;
@@ -45,6 +46,7 @@ const PRODUCT_FIELDS = [
     'comparePrice',
     'category',
     'categoryId',
+    'game',
     'storeCategoryId',
     'tags',
     'images',
@@ -55,6 +57,24 @@ const PRODUCT_FIELDS = [
     'dynamicUrl',
     'licenseDeviceLimit',
     'licenseDurationDays',
+    'deliveryType',
+    'deliveryPayload',
+    'revokePayload',
+    'coinConfig',
+    'visibility',
+    'sortPriority',
+    'deliveryNote',
+    'termsOfService',
+    'warrantyDays',
+    'warrantyText',
+    'blockVpn',
+    'maxRiskScore',
+    'customFields',
+    'minQuantity',
+    'maxQuantity',
+    'volumeDiscounts',
+    'upsells',
+    'prices',
 ];
 const COUPON_FIELDS = [
     'discountType',
@@ -103,11 +123,12 @@ export class Skalp {
         get: (id) => this.#request('GET', `/v1/checkout/sessions/${segment(id)}`),
     };
     orders = {
-        list: ({ status, productId, email, createdAfter, createdBefore, updatedSince, limit, offset } = {}) => this.#request('GET', '/v1/orders', {
+        list: ({ status, productId, email, identifier, createdAfter, createdBefore, updatedSince, limit, offset } = {}) => this.#request('GET', '/v1/orders', {
             query: {
                 status,
                 productId,
                 email,
+                identifier,
                 createdAfter: optionalDate(createdAfter),
                 createdBefore: optionalDate(createdBefore),
                 updatedSince: optionalDate(updatedSince),
@@ -117,12 +138,27 @@ export class Skalp {
         }),
         get: (id) => this.#request('GET', `/v1/orders/${segment(id)}`),
         cancel: (id) => this.#request('POST', `/v1/orders/${segment(id)}/cancel`),
+        redeliver: (id) => this.#request('POST', `/v1/orders/${segment(id)}/redeliver`),
         replace: (id, { serialIds, values, reason } = {}) => this.#request('POST', `/v1/orders/${segment(id)}/replacement`, {
             body: { serialIds, values, reason },
         }),
     };
     products = {
-        list: ({ status } = {}) => this.#request('GET', '/v1/products', { query: { status } }),
+        list: async ({ status, limit, offset } = {}) => {
+            if (limit !== undefined || offset !== undefined) {
+                return (await this.#send('GET', '/v1/products', { query: { status, limit, offset } })).data;
+            }
+            const products = [];
+            for (;;) {
+                const page = await this.#send('GET', '/v1/products', {
+                    query: { status, limit: PRODUCT_PAGE, offset: products.length },
+                });
+                products.push(...page.data);
+                const total = Number(page.headers.get('x-total-count'));
+                if (page.data.length < PRODUCT_PAGE || products.length >= total)
+                    return products;
+            }
+        },
         get: (idOrSlug) => this.#request('GET', `/v1/products/${segment(idOrSlug)}`),
         create: (params) => this.#request('POST', '/v1/products', {
             body: pick(params, [...PRODUCT_FIELDS, 'productType', 'submit']),
@@ -288,13 +324,19 @@ export class Skalp {
         const hmac = await crypto.subtle.importKey('raw', encoder.encode(key), { name: 'HMAC', hash: 'SHA-256' }, false, ['verify']);
         return (await crypto.subtle.verify('HMAC', hmac, parsed.signature, signed)) ? undefined : 'invalid';
     }
-    async #request(method, path, { body, query, auth = true } = {}) {
+    async #request(method, path, options = {}) {
+        return (await this.#send(method, path, options)).data;
+    }
+    async #send(method, path, { body, query, auth = true } = {}) {
         if (auth && !this.#apiKey) {
             throw new Error('Skalp: missing API key. Pass it to new Skalp(apiKey) or set SKALP_API_KEY.');
         }
         const url = new URL(this.#baseUrl + path);
         for (const [name, value] of Object.entries(query ?? {})) {
-            if (value !== undefined && value !== null)
+            if (Array.isArray(value))
+                for (const item of value)
+                    url.searchParams.append(name, String(item));
+            else if (value !== undefined && value !== null)
                 url.searchParams.set(name, String(value));
         }
         const headers = { accept: 'application/json', 'user-agent': USER_AGENT };
@@ -333,7 +375,7 @@ export class Skalp {
             }
             if (!res.ok)
                 throw toError(res.status, data);
-            return data;
+            return { data: data, headers: res.headers };
         }
     }
 }

package/dist/esm/types.d.ts

@@ -2,6 +2,7 @@ export type Currency = 'EUR' | 'USD' | 'PLN' | (string & {});
 export type FulfillmentType = 'FILE' | 'SERIAL' | 'GAME' | 'SERVICE' | 'DYNAMIC' | 'LICENSE';
 export type ProductStatus = 'DRAFT' | 'PENDING_REVIEW' | 'PROCESSING' | 'PROCESSING_FAILED' | 'ACTIVE' | 'REJECTED' | 'ARCHIVED';
 export type ProductType = 'ONE_TIME' | 'RECURRING' | 'COINS';
+export type Game = 'fivem' | 'minecraft' | 'rust';
 export type BillingInterval = 'WEEK' | 'MONTH' | 'YEAR';
 export type OrderStatus = 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'REFUNDED' | 'DISPUTED' | 'CANCELED';
 export type PaymentProvider = 'STRIPE' | 'NOWPAYMENTS' | 'PAYPAL';
@@ -91,6 +92,7 @@ export interface ListOrdersParams {
     status?: OrderStatus;
     productId?: string;
     email?: string;
+    identifier?: string | Array<string>;
     createdAfter?: string | Date;
     createdBefore?: string | Date;
     updatedSince?: string | Date;
@@ -176,6 +178,10 @@ export type DeliveryType = 'COMMAND' | 'SQL';
  * ON_HOLD is listed but not buyable, PRIVATE sells only through the API.
  */
 export type ProductVisibility = 'PUBLIC' | 'UNLISTED' | 'ON_HOLD' | 'PRIVATE';
+export interface ProductPrice {
+    currency: Currency;
+    price: number;
+}
 export interface Product {
     id: string;
     storeId: string;
@@ -186,12 +192,15 @@ export interface Product {
     price: number;
     comparePrice: number | null;
     currency: Currency;
+    /** Round prices the seller set in other currencies. A buyer whose local currency is listed pays it exactly. */
+    prices: Array<ProductPrice>;
     status: ProductStatus;
     rejectionReason: string | null;
     productType: ProductType;
     billingInterval: BillingInterval | null;
     trialPeriodDays: number;
     fulfillmentType: FulfillmentType | null;
+    game: Game | null;
     category: string;
     categoryId: string | null;
     storeCategoryId: string | null;
@@ -205,6 +214,13 @@ export interface Product {
     deliveryType: DeliveryType | null;
     /** Server stores: what the game server runs after payment. */
     deliveryPayload: string | null;
+    revokePayload: string | null;
+    coinConfig: CoinConfig | null;
+    pendingChanges: {
+        submittedAt: string;
+        changes: Partial<Record<ReviewedProductField, unknown>>;
+    } | null;
+    pendingChangesRejection: string | null;
     visibility: ProductVisibility;
     /** Higher comes first on the store page. */
     sortPriority: number;
@@ -232,8 +248,24 @@ export interface Product {
     createdAt: string;
     updatedAt: string;
 }
+export interface CoinBonusTier {
+    thresholdCoins: number;
+    bonusPercent: number;
+}
+export interface CoinConfig {
+    unitPriceCents: number;
+    minQty: number;
+    maxQty: number;
+    step: number;
+    currency: string;
+    bonusTiers: Array<CoinBonusTier>;
+}
+export type CoinConfigInput = Omit<CoinConfig, 'currency'>;
+export type ReviewedProductField = 'name' | 'shortDescription' | 'description' | 'images' | 'videoUrl' | 'features' | 'requirements' | 'customFields' | 'deliveryNote' | 'termsOfService' | 'warrantyText' | 'deliveryType' | 'deliveryPayload' | 'revokePayload';
 export interface ListProductsParams {
     status?: ProductStatus | 'all';
+    limit?: number;
+    offset?: number;
 }
 interface ProductFields {
     slug?: string;
@@ -241,6 +273,7 @@ interface ProductFields {
     shortDescription?: string;
     category?: string;
     categoryId?: string;
+    game?: Game | null;
     storeCategoryId?: string | null;
     tags?: Array<string>;
     images?: Array<string>;
@@ -255,6 +288,8 @@ interface ProductFields {
     deliveryType?: DeliveryType;
     /** Required for a server store; needs a placeholder such as {steamhex}. */
     deliveryPayload?: string;
+    revokePayload?: string;
+    coinConfig?: CoinConfigInput;
     visibility?: ProductVisibility;
     sortPriority?: number;
     /** null or an empty string clears it. */
@@ -274,12 +309,14 @@ interface ProductFields {
     volumeDiscounts?: Array<VolumeDiscount> | null;
     /** Up to 3 one-time products of the store; the list replaces the old one, [] or null removes them all. */
     upsells?: Array<ProductUpsellInput> | null;
+    /** Up to 3 currencies other than the store currency, not for coin packs; the list replaces the old one, [] or null removes them all. */
+    prices?: Array<ProductPrice> | null;
 }
 export interface CreateProductParams extends ProductFields {
     name: string;
     price: number;
     comparePrice?: number;
-    productType?: 'ONE_TIME' | 'RECURRING';
+    productType?: 'ONE_TIME' | 'RECURRING' | 'COINS';
     submit?: boolean;
 }
 export interface UpdateProductParams extends ProductFields {
@@ -799,6 +836,16 @@ export interface OrderRefundedData {
     granted?: boolean;
     fullRefund: boolean;
     licenses: Array<WebhookLicense>;
+    revocations: Array<Revocation>;
+}
+export interface Revocation {
+    productId: string;
+    productSlug: string;
+    productName: string;
+    deliveryKey: string;
+    delivered: boolean;
+    deliveryType: DeliveryType;
+    revokeCommand: string;
 }
 export interface OrderDisputedData {
     orderId: string;
@@ -851,6 +898,7 @@ export interface ProductEventData {
     price: number;
     fulfillmentType: FulfillmentType | null;
     productType: ProductType;
+    game: Game | null;
 }
 export interface ProductStockData {
     productId: string;
@@ -914,6 +962,7 @@ export type SkalpEvent = Envelope<'order.created' | 'order.updated' | 'order.can
 }> | Envelope<'subscription.canceled', SubscriptionEventData & {
     endedAt: string | null;
     cancelReason: 'requested' | 'payment_failure' | 'dispute' | 'stripe';
+    revokeCommand?: string;
 }> | Envelope<'subscription.refunded', SubscriptionEventData & {
     invoiceId: string;
     amountRefunded: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skalpgg/sdk",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Official Skalp SDK for Node.js and edge runtimes: checkout, subscriptions, catalog and key stock, webhooks and license verification.",
   "license": "MIT",
   "homepage": "https://skalp.gg/docs/sdk",