itd-api 0.8.0 → 0.9.0

package/dist/shared/{render-DNTESBSl.cjs → render-Dqi8Owqk.cjs}

@@ -1,7 +1,8 @@
-const require_url = require("./url-CFN1sT9S.cjs");
+const require_url = require("./url-Bsb3xE5U.cjs");
 const require_errors = require("./errors-BmP3TKoW.cjs");
-const require_redact = require("./redact-DB9EMGJx.cjs");
-const require_options = require("./options-BUfoHE9G.cjs");
+const require_redact = require("./redact-BP00URmQ.cjs");
+const require_options = require("./options-DOJYtoti.cjs");
+const require_key_value_store = require("./key-value-store-B5GYVEYZ.cjs");
 //#region src/core/feature-catalog.ts
 /**
 * Изменяемый слой над каталогом конкретного API.
@@ -3531,6 +3532,195 @@ var SearchResource = class extends BaseResource {
 	}
 };
 //#endregion
+//#region src/resources/shop.ts
+const PRODUCTS_LIST = require_url.passthroughOperation("shop.products.list");
+const PRODUCTS_GET = require_url.passthroughOperation("shop.products.get");
+const DELIVERY_COUNTRIES = require_url.passthroughOperation("shop.delivery.countries");
+const DELIVERY_CITIES = require_url.passthroughOperation("shop.delivery.cities");
+const DELIVERY_POINTS = require_url.passthroughOperation("shop.delivery.points");
+const DELIVERY_CALCULATE = require_url.passthroughOperation("shop.delivery.calculate");
+const ORDERS_CREATE = require_url.passthroughOperation("shop.orders.create");
+const ORDERS_LIST = require_url.passthroughOperation("shop.orders.list");
+const ORDERS_GET = require_url.passthroughOperation("shop.orders.get");
+const ORDERS_PAY = require_url.passthroughOperation("shop.orders.pay");
+const ORDERS_REQUEST_ACCESS_CODE = require_url.voidOperation("shop.orders.requestAccessCode");
+const ORDERS_VERIFY_ACCESS_CODE = require_url.passthroughOperation("shop.orders.verifyAccessCode");
+const CONSENTS_RECORD = require_url.voidOperation("shop.consents.record");
+function orderRequestOptions(options) {
+	const { orderAccessToken, useItdAuth, headers, ...request } = options;
+	return {
+		...request,
+		...useItdAuth === false ? { skipAuth: true } : {},
+		headers: {
+			...headers,
+			...orderAccessToken ? { "X-Order-Token": orderAccessToken } : {}
+		}
+	};
+}
+/** Каталог товаров магазина. */
+var ShopProductsResource = class extends BaseResource {
+	/** Загружает все товары. */
+	list(options = {}) {
+		return this.http.execute(PRODUCTS_LIST, {
+			path: "/api/v1/shop/products",
+			raw: true,
+			...options
+		});
+	}
+	/** Загружает товар по идентификатору. */
+	async get(productId, options = {}) {
+		try {
+			return await this.http.execute(PRODUCTS_GET, {
+				path: `/api/v1/shop/products/${require_redact.encodePathSegment(productId, "идентификатор товара")}`,
+				raw: true,
+				...options
+			});
+		} catch (error) {
+			if (require_errors.isItdApiError(error) && error.status === 404) return null;
+			throw error;
+		}
+	}
+};
+/** Расчёт и выбор доставки. */
+var ShopDeliveryResource = class extends BaseResource {
+	/** Загружает страны, в которые доступна доставка. */
+	countries(options = {}) {
+		return this.http.execute(DELIVERY_COUNTRIES, {
+			path: "/api/v1/shop/delivery/countries",
+			raw: true,
+			...options
+		});
+	}
+	/** Ищет города службы доставки. */
+	cities(query, countryCode, options = {}) {
+		return this.http.execute(DELIVERY_CITIES, {
+			path: "/api/v1/shop/delivery/cities",
+			query: {
+				q: query,
+				country: countryCode
+			},
+			raw: true,
+			...options
+		});
+	}
+	/** Загружает пункты выдачи в городе. */
+	points(cityCode, options = {}) {
+		return this.http.execute(DELIVERY_POINTS, {
+			path: "/api/v1/shop/delivery/points",
+			query: { cityCode },
+			raw: true,
+			...options
+		});
+	}
+	/** Рассчитывает стоимость и срок доставки. */
+	calculate(items, destination, options = {}) {
+		return this.http.execute(DELIVERY_CALCULATE, {
+			path: "/api/v1/shop/delivery/calculate",
+			body: {
+				items,
+				to: destination
+			},
+			raw: true,
+			...options
+		});
+	}
+};
+/** Создание, просмотр и оплата заказов. */
+var ShopOrdersResource = class extends BaseResource {
+	/** Создаёт заказ. */
+	create(input, options = {}) {
+		const { idempotencyKey = require_redact.createDeviceId(), headers, ...request } = options;
+		return this.http.execute(ORDERS_CREATE, {
+			path: "/api/v1/shop/orders",
+			body: input,
+			headers: {
+				...headers,
+				"Idempotency-Key": idempotencyKey
+			},
+			raw: true,
+			...request
+		});
+	}
+	/** Загружает заказы аккаунта ИТД или владельца временного токена. */
+	list(options = {}) {
+		return this.http.execute(ORDERS_LIST, {
+			path: "/api/v1/shop/orders/my",
+			raw: true,
+			...orderRequestOptions(options)
+		});
+	}
+	/** Загружает заказ по номеру. */
+	get(orderNumber, options = {}) {
+		return this.http.execute(ORDERS_GET, {
+			path: `/api/v1/shop/orders/${require_redact.encodePathSegment(orderNumber, "номер заказа")}`,
+			raw: true,
+			...orderRequestOptions(options)
+		});
+	}
+	/** Создаёт ссылку на оплату заказа. */
+	pay(orderNumber, options) {
+		const { returnUrl, ...access } = options;
+		return this.http.execute(ORDERS_PAY, {
+			path: `/api/v1/shop/orders/${require_redact.encodePathSegment(orderNumber, "номер заказа")}/pay`,
+			body: { returnUrl },
+			raw: true,
+			...orderRequestOptions(access)
+		});
+	}
+	/** Отправляет на почту код доступа к гостевым заказам. */
+	requestAccessCode(email, options = {}) {
+		return this.http.execute(ORDERS_REQUEST_ACCESS_CODE, {
+			path: "/api/v1/shop/orders/lookup/request",
+			body: { email },
+			raw: true,
+			skipAuth: true,
+			...options
+		});
+	}
+	/** Проверяет код из письма и возвращает временный токен заказов. */
+	verifyAccessCode(email, code, options = {}) {
+		return this.http.execute(ORDERS_VERIFY_ACCESS_CODE, {
+			path: "/api/v1/shop/orders/lookup/verify",
+			body: {
+				email,
+				code
+			},
+			raw: true,
+			skipAuth: true,
+			...options
+		});
+	}
+};
+/** Запись согласий магазина. */
+var ShopConsentsResource = class extends BaseResource {
+	/** Записывает согласия покупателя. */
+	record(consents, consentContext, options = {}) {
+		return this.http.execute(CONSENTS_RECORD, {
+			path: "/api/v1/shop/consents",
+			body: {
+				consents,
+				consentContext
+			},
+			raw: true,
+			...options
+		});
+	}
+};
+/** Магазин ИТД. */
+var ShopResource = class {
+	products;
+	delivery;
+	orders;
+	consents;
+	/** @internal */
+	constructor(http) {
+		this.products = new ShopProductsResource(http);
+		this.delivery = new ShopDeliveryResource(http);
+		this.orders = new ShopOrdersResource(http);
+		this.consents = new ShopConsentsResource(http);
+	}
+};
+//#endregion
 //#region src/resources/subscription.ts
 const SUBSCRIPTION_METHODS = require_url.defineBuiltInOperation("subscription.methods", (body) => Array.isArray(body) ? body : []);
 const SUBSCRIPTION_STATUS = require_url.passthroughOperation("subscription.status");
@@ -4282,6 +4472,7 @@ function createResources(deps) {
 	let subscription;
 	let platform;
 	let telemetry;
+	let shop;
 	const bag = {
 		get users() {
 			users ??= new UsersResource(deps.http, { uploadFile });
@@ -4331,6 +4522,10 @@ function createResources(deps) {
 			telemetry ??= new TelemetryResource(deps.http);
 			return telemetry;
 		},
+		get shop() {
+			shop ??= new ShopResource(deps.http);
+			return shop;
+		},
 		closeTelemetry: (forDispose) => forDispose ? closeTelemetryForDispose(telemetry) : telemetry?.close() ?? Promise.resolve(),
 		prepareTelemetryClose: () => prepareTelemetryForDispose(telemetry)
 	};
@@ -4404,6 +4599,36 @@ function isMyProfile(profile) {
 	return "subscription" in profile;
 }
 //#endregion
+//#region src/models/shop.ts
+/** Категория товара магазина. */
+const ShopProductCategory = Object.freeze({
+	Apparel: "apparel",
+	Accessories: "accessories",
+	Print: "print"
+});
+/** Состояние товара в каталоге. */
+const ShopProductStatus = Object.freeze({
+	Available: "available",
+	Preorder: "preorder",
+	SoldOut: "soldout"
+});
+/** Вид согласия, которое принимает покупатель. */
+const ShopConsentKind = Object.freeze({
+	Offer: "offer",
+	PersonalData: "personal_data",
+	Cookie: "cookie"
+});
+/** Состояние заказа. */
+const ShopOrderStatus = Object.freeze({
+	New: "new",
+	Paid: "paid",
+	Shipping: "ship",
+	Done: "done",
+	Cancelled: "cancelled",
+	Refunded: "refunded",
+	Expired: "expired"
+});
+//#endregion
 //#region src/models/status-helpers.ts
 const STATUS_WINDOW_DAYS = 90;
 /**
@@ -4425,6 +4650,186 @@ function statusDays(service) {
 	return Array.from({ length: STATUS_WINDOW_DAYS }, (_, index) => service.days[String(index)] ?? null);
 }
 //#endregion
+//#region src/shop/order-access.ts
+function copySession(session) {
+	return { ...session };
+}
+/** Хранилище доступа к заказам в памяти процесса. */
+var MemoryShopOrderAccessStorage = class {
+	#session;
+	constructor(initial = null) {
+		this.#session = initial ? copySession(initial) : null;
+	}
+	get() {
+		return this.#session ? copySession(this.#session) : null;
+	}
+	set(session) {
+		this.#session = copySession(session);
+	}
+	clear() {
+		this.#session = null;
+	}
+};
+/** Создаёт хранилище доступа к заказам поверх `KeyValueStore`. */
+function createShopOrderAccessStorage(store, options = {}) {
+	const key = options.key ?? "shop-order-access";
+	if (typeof key !== "string" || key.length === 0) throw new require_errors.ItdConfigError("ключ хранилища доступа к заказам должен быть непустой строкой");
+	const backend = require_key_value_store.createKeyValueStore(store);
+	return {
+		async get() {
+			const session = await backend.get(key);
+			return session ? copySession(session) : null;
+		},
+		set: (session) => backend.set(key, copySession(session)),
+		clear: () => backend.delete(key)
+	};
+}
+/** Создаёт независимое хранилище доступа к заказам в памяти. */
+function createMemoryShopOrderAccessStorage() {
+	return createShopOrderAccessStorage(new require_key_value_store.MemoryKeyValueStore());
+}
+//#endregion
+//#region src/shop/feature.ts
+const Operation = Object.freeze({
+	RequestCode: "request-code",
+	VerifyCode: "verify-code",
+	List: "list",
+	Get: "get",
+	Pay: "pay"
+});
+function requireEmail(value) {
+	const email = value.trim();
+	if (!email?.includes("@")) throw new require_errors.ItdConfigError("укажите адрес почты");
+	return email;
+}
+/** Создаёт подключаемый модуль для доступа к заказам по коду из письма. */
+function createShopFeature(options = {}) {
+	return {
+		name: "shop",
+		buckets: {
+			[Operation.RequestCode]: { limit: 4 },
+			[Operation.VerifyCode]: { limit: 13 },
+			[Operation.List]: { limit: 150 },
+			[Operation.Get]: { limit: 150 },
+			[Operation.Pay]: { limit: 13 }
+		},
+		operations: {
+			[Operation.RequestCode]: {
+				method: "POST",
+				retrySafety: require_url.RetrySafety.Unsafe,
+				read: require_url.voidResult,
+				bucket: Operation.RequestCode
+			},
+			[Operation.VerifyCode]: {
+				method: "POST",
+				retrySafety: require_url.RetrySafety.Unsafe,
+				bucket: Operation.VerifyCode
+			},
+			[Operation.List]: {
+				method: "GET",
+				retrySafety: require_url.RetrySafety.Safe,
+				bucket: Operation.List
+			},
+			[Operation.Get]: {
+				method: "GET",
+				retrySafety: require_url.RetrySafety.Safe,
+				bucket: Operation.Get
+			},
+			[Operation.Pay]: {
+				method: "POST",
+				retrySafety: require_url.RetrySafety.Unsafe,
+				bucket: Operation.Pay
+			}
+		},
+		setup(context) {
+			const storage = options.storage ?? createMemoryShopOrderAccessStorage();
+			let pendingEmail = null;
+			const readSession = async () => {
+				const session = await storage.get();
+				if (!session) return null;
+				if (session.expiresAt > context.clock.now()) return { ...session };
+				await storage.clear();
+				return null;
+			};
+			const requireSession = async () => {
+				const session = await readSession();
+				if (!session) throw new require_errors.ItdConfigError("доступ к заказам отсутствует или истёк; запросите новый код");
+				return session;
+			};
+			const withAccess = async (run) => {
+				const session = await requireSession();
+				try {
+					return await run(session.token);
+				} catch (error) {
+					if (require_errors.isItdApiError(error) && error.status === 401) await storage.clear();
+					throw error;
+				}
+			};
+			const request = (operation, token, requestOptions) => context.request(operation, {
+				...requestOptions,
+				headers: {
+					...requestOptions.headers,
+					"X-Order-Token": token
+				},
+				skipAuth: true,
+				raw: true
+			});
+			return { api: Object.freeze({
+				async requestCode(email, requestOptions = {}) {
+					const normalized = requireEmail(email);
+					await context.request(Operation.RequestCode, {
+						path: "/api/v1/shop/orders/lookup/request",
+						body: { email: normalized },
+						skipAuth: true,
+						raw: true,
+						...requestOptions
+					});
+					pendingEmail = normalized;
+				},
+				async verifyCode(code, requestOptions = {}) {
+					if (!pendingEmail) throw new require_errors.ItdConfigError("сначала запросите код для адреса почты");
+					const verified = await context.request(Operation.VerifyCode, {
+						path: "/api/v1/shop/orders/lookup/verify",
+						body: {
+							email: pendingEmail,
+							code
+						},
+						skipAuth: true,
+						raw: true,
+						...requestOptions
+					});
+					const session = {
+						email: pendingEmail,
+						token: verified.token,
+						expiresAt: context.clock.now() + verified.expiresInSec * 1e3
+					};
+					await storage.set(session);
+					pendingEmail = null;
+					return { ...session };
+				},
+				session: readSession,
+				async clear() {
+					pendingEmail = null;
+					await storage.clear();
+				},
+				list: (requestOptions = {}) => withAccess((token) => request(Operation.List, token, {
+					path: "/api/v1/shop/orders/my",
+					...requestOptions
+				})),
+				get: (orderNumber, requestOptions = {}) => withAccess((token) => request(Operation.Get, token, {
+					path: `/api/v1/shop/orders/${require_redact.encodePathSegment(orderNumber, "номер заказа")}`,
+					...requestOptions
+				})),
+				pay: (orderNumber, returnUrl, requestOptions = {}) => withAccess((token) => request(Operation.Pay, token, {
+					path: `/api/v1/shop/orders/${require_redact.encodePathSegment(orderNumber, "номер заказа")}/pay`,
+					body: { returnUrl },
+					...requestOptions
+				}))
+			}) };
+		}
+	};
+}
+//#endregion
 //#region src/spans/render.ts
 /** Формат результата {@link renderSpans}. */
 const SpanRenderFormat = Object.freeze({
@@ -4657,6 +5062,12 @@ Object.defineProperty(exports, "IMAGE_MIME_TYPES", {
 		return IMAGE_MIME_TYPES;
 	}
 });
+Object.defineProperty(exports, "MemoryShopOrderAccessStorage", {
+	enumerable: true,
+	get: function() {
+		return MemoryShopOrderAccessStorage;
+	}
+});
 Object.defineProperty(exports, "NotificationsResource", {
 	enumerable: true,
 	get: function() {
@@ -4675,6 +5086,30 @@ Object.defineProperty(exports, "Paginator", {
 		return Paginator;
 	}
 });
+Object.defineProperty(exports, "ShopConsentKind", {
+	enumerable: true,
+	get: function() {
+		return ShopConsentKind;
+	}
+});
+Object.defineProperty(exports, "ShopOrderStatus", {
+	enumerable: true,
+	get: function() {
+		return ShopOrderStatus;
+	}
+});
+Object.defineProperty(exports, "ShopProductCategory", {
+	enumerable: true,
+	get: function() {
+		return ShopProductCategory;
+	}
+});
+Object.defineProperty(exports, "ShopProductStatus", {
+	enumerable: true,
+	get: function() {
+		return ShopProductStatus;
+	}
+});
 Object.defineProperty(exports, "SpanRenderFormat", {
 	enumerable: true,
 	get: function() {
@@ -4705,12 +5140,30 @@ Object.defineProperty(exports, "createFeatureHost", {
 		return createFeatureHost;
 	}
 });
+Object.defineProperty(exports, "createMemoryShopOrderAccessStorage", {
+	enumerable: true,
+	get: function() {
+		return createMemoryShopOrderAccessStorage;
+	}
+});
 Object.defineProperty(exports, "createResources", {
 	enumerable: true,
 	get: function() {
 		return createResources;
 	}
 });
+Object.defineProperty(exports, "createShopFeature", {
+	enumerable: true,
+	get: function() {
+		return createShopFeature;
+	}
+});
+Object.defineProperty(exports, "createShopOrderAccessStorage", {
+	enumerable: true,
+	get: function() {
+		return createShopOrderAccessStorage;
+	}
+});
 Object.defineProperty(exports, "createStatusFeature", {
 	enumerable: true,
 	get: function() {
@@ -4808,4 +5261,4 @@ Object.defineProperty(exports, "utcStampToIso", {
 	}
 });
 
-//# sourceMappingURL=render-DNTESBSl.cjs.map
+//# sourceMappingURL=render-Dqi8Owqk.cjs.map