itd-api 0.8.0 → 0.9.0

package/dist/shared/{render-CiL1VS0b.js → render-hiWFh2s4.js}

@@ -1,7 +1,8 @@
-import { B as isRecord, C as ReportReason, E as SpanType, G as pickString, H as pickBoolean, J as identityResult, K as RetrySafety, M as defineBuiltInOperation, U as pickNumber, V as pickArray, W as pickObject, Y as mergeService, c as normalizeNotification, et as DEFAULT_STATUS_BASE_URL, o as passthroughOperation, q as defineOperation, s as voidOperation, st as createDeadline, tt as STATUS_SERVICE, w as ReportTargetType, y as InteractionType } from "./url-B3ocFlHj.js";
-import { _ as ItdStateError, a as ItdConfigError, l as ItdFileError, s as ItdError, t as ItdAbortError, u as ItdFileErrorReason } from "./errors-GI10kZxk.js";
-import { a as redactUrl, b as isFile, d as encodePathSegment, r as redactErrorCause, v as createDeviceId, y as isBlob } from "./redact-FNK29Fv-.js";
-import { a as fileTooLarge, c as FileTransferMode, i as isReadableByteStream, n as boundedFileStream, o as optionalBytes, r as isBoundedFileStream, s as DEFAULT_URL_FILE_MAX_BYTES, t as resolveFileStreamOptions } from "./options-BNP633A5.js";
+import { B as isRecord, C as ReportReason, E as SpanType, G as pickString, H as pickBoolean, J as identityResult, K as RetrySafety, M as defineBuiltInOperation, U as pickNumber, V as pickArray, W as pickObject, X as mergeService, Y as voidResult, c as normalizeNotification, ct as createDeadline, nt as STATUS_SERVICE, o as passthroughOperation, q as defineOperation, s as voidOperation, tt as DEFAULT_STATUS_BASE_URL, w as ReportTargetType, y as InteractionType } from "./url-DP33mp3s.js";
+import { _ as ItdStateError, a as ItdConfigError, b as isItdApiError, l as ItdFileError, s as ItdError, t as ItdAbortError, u as ItdFileErrorReason } from "./errors-GI10kZxk.js";
+import { a as redactUrl, b as isFile, d as encodePathSegment, r as redactErrorCause, v as createDeviceId, y as isBlob } from "./redact-Ba5iSVYZ.js";
+import { a as fileTooLarge, c as FileTransferMode, i as isReadableByteStream, n as boundedFileStream, o as optionalBytes, r as isBoundedFileStream, s as DEFAULT_URL_FILE_MAX_BYTES, t as resolveFileStreamOptions } from "./options-DhgGg7Ms.js";
+import { r as createKeyValueStore, t as MemoryKeyValueStore } from "./key-value-store-Bt2PSMxY.js";
 //#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 = passthroughOperation("shop.products.list");
+const PRODUCTS_GET = passthroughOperation("shop.products.get");
+const DELIVERY_COUNTRIES = passthroughOperation("shop.delivery.countries");
+const DELIVERY_CITIES = passthroughOperation("shop.delivery.cities");
+const DELIVERY_POINTS = passthroughOperation("shop.delivery.points");
+const DELIVERY_CALCULATE = passthroughOperation("shop.delivery.calculate");
+const ORDERS_CREATE = passthroughOperation("shop.orders.create");
+const ORDERS_LIST = passthroughOperation("shop.orders.list");
+const ORDERS_GET = passthroughOperation("shop.orders.get");
+const ORDERS_PAY = passthroughOperation("shop.orders.pay");
+const ORDERS_REQUEST_ACCESS_CODE = voidOperation("shop.orders.requestAccessCode");
+const ORDERS_VERIFY_ACCESS_CODE = passthroughOperation("shop.orders.verifyAccessCode");
+const CONSENTS_RECORD = 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/${encodePathSegment(productId, "идентификатор товара")}`,
+				raw: true,
+				...options
+			});
+		} catch (error) {
+			if (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 = 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/${encodePathSegment(orderNumber, "номер заказа")}`,
+			raw: true,
+			...orderRequestOptions(options)
+		});
+	}
+	/** Создаёт ссылку на оплату заказа. */
+	pay(orderNumber, options) {
+		const { returnUrl, ...access } = options;
+		return this.http.execute(ORDERS_PAY, {
+			path: `/api/v1/shop/orders/${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 = defineBuiltInOperation("subscription.methods", (body) => Array.isArray(body) ? body : []);
 const SUBSCRIPTION_STATUS = 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 ItdConfigError("ключ хранилища доступа к заказам должен быть непустой строкой");
+	const backend = 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 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 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: RetrySafety.Unsafe,
+				read: voidResult,
+				bucket: Operation.RequestCode
+			},
+			[Operation.VerifyCode]: {
+				method: "POST",
+				retrySafety: RetrySafety.Unsafe,
+				bucket: Operation.VerifyCode
+			},
+			[Operation.List]: {
+				method: "GET",
+				retrySafety: RetrySafety.Safe,
+				bucket: Operation.List
+			},
+			[Operation.Get]: {
+				method: "GET",
+				retrySafety: RetrySafety.Safe,
+				bucket: Operation.Get
+			},
+			[Operation.Pay]: {
+				method: "POST",
+				retrySafety: 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 ItdConfigError("доступ к заказам отсутствует или истёк; запросите новый код");
+				return session;
+			};
+			const withAccess = async (run) => {
+				const session = await requireSession();
+				try {
+					return await run(session.token);
+				} catch (error) {
+					if (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 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/${encodePathSegment(orderNumber, "номер заказа")}`,
+					...requestOptions
+				})),
+				pay: (orderNumber, returnUrl, requestOptions = {}) => withAccess((token) => request(Operation.Pay, token, {
+					path: `/api/v1/shop/orders/${encodePathSegment(orderNumber, "номер заказа")}/pay`,
+					body: { returnUrl },
+					...requestOptions
+				}))
+			}) };
+		}
+	};
+}
+//#endregion
 //#region src/spans/render.ts
 /** Формат результата {@link renderSpans}. */
 const SpanRenderFormat = Object.freeze({
@@ -4627,6 +5032,6 @@ function renderSpans(content, spans = [], options = {}) {
 	return result;
 }
 //#endregion
-export { ExtensibleOperationCatalog as A, utcStampToIso as C, Paginator as D, PaginationMode as E, mapPage as O, toDate as S, BaseResource as T, IMAGE_MIME_TYPES as _, fromStream as a, isBuilder as b, report as c, autoSpans as d, markup as f, AUDIO_MIME_TYPES as g, ALLOWED_MIME_TYPES as h, isMyProfile as i, createFeatureHost as k, post as l, parseMarkdown as m, renderSpans as n, fromUrl as o, parseHtml as p, statusDays as r, createResources as s, SpanRenderFormat as t, poll as u, VIDEO_MIME_TYPES as v, NotificationsResource as w, createStatusFeature as x, comment as y };
+export { toDate as A, ALLOWED_MIME_TYPES as C, comment as D, VIDEO_MIME_TYPES as E, Paginator as F, mapPage as I, createFeatureHost as L, NotificationsResource as M, BaseResource as N, isBuilder as O, PaginationMode as P, ExtensibleOperationCatalog as R, parseMarkdown as S, IMAGE_MIME_TYPES as T, post as _, createMemoryShopOrderAccessStorage as a, markup as b, ShopConsentKind as c, ShopProductStatus as d, isMyProfile as f, report as g, createResources as h, MemoryShopOrderAccessStorage as i, utcStampToIso as j, createStatusFeature as k, ShopOrderStatus as l, fromUrl as m, renderSpans as n, createShopOrderAccessStorage as o, fromStream as p, createShopFeature as r, statusDays as s, SpanRenderFormat as t, ShopProductCategory as u, poll as v, AUDIO_MIME_TYPES as w, parseHtml as x, autoSpans as y };
 
-//# sourceMappingURL=render-CiL1VS0b.js.map
+//# sourceMappingURL=render-hiWFh2s4.js.map