@zenky/storefront-vue 0.10.0 → 0.10.4

package/dist/utils/index.d.ts

@@ -1,5 +1,4 @@
-import { Phone } from '@zenky/storefront-api';
-export { D as DayScheduleInfo, S as SocialLink, T as TodayScheduleInfo, f as formatScheduleStatus, g as getEmailLink, a as getSocialLinks, b as getTodayInfo, c as getWebsiteLink, d as getWeeklySchedule } from '../schedule-Dd3zwHEb.js';
+import { Phone, ContactType, Contact, Schedule } from '@zenky/storefront-api';
 
 declare function createDebounce(fn: () => void, delay: number): () => void;
 
@@ -17,12 +16,36 @@ declare function getPhoneTelLink(phone: Phone | null | undefined): string | null
  */
 declare function formatPhoneSpaced(formatted: string | null | undefined): string;
 
+interface SocialLink {
+    type: ContactType;
+    url: string;
+    label: string;
+}
+declare function getSocialLinks(contacts: Contact[]): SocialLink[];
+declare function getEmailLink(contacts: Contact[]): string | null;
+declare function getWebsiteLink(contacts: Contact[]): string | null;
+
+interface DayScheduleInfo {
+    dayKey: string;
+    name: string;
+    hours: string | null;
+}
+interface TodayScheduleInfo {
+    isOpenNow: boolean;
+    todayHours: string | null;
+    openingAt: string | null;
+    closingAt: string | null;
+}
+declare function getTodayInfo(schedule: Schedule | null | undefined): TodayScheduleInfo | null;
+declare function getWeeklySchedule(schedule: Schedule | null | undefined, locale?: string): DayScheduleInfo[];
+declare function formatScheduleStatus(schedule: Schedule | null | undefined, locale?: string): string | null;
+
 /**
  * Генерирует URL картинки QR-кода через Zenky media API.
  *
  * Контент кодируется в base64 и передаётся в query `content`.
- * `btoa` работает только с Latin-1 — для юникода предварительно прогоняем через
- * `encodeURIComponent` + `unescape`. На сервере используем Buffer.
+ * Реализация не зависит от `window`, `btoa` или Node.js `Buffer`, поэтому один
+ * и тот же код работает в браузере, Node SSR и edge runtimes.
  */
 declare function buildQrCodeUrl(target: string, apiBaseUrl: string, size?: number): string;
 
@@ -63,4 +86,4 @@ declare function getApiFieldErrors(e: unknown): Record<string, string[]> | null;
  */
 declare function formatAddressCityLast(raw: string): string;
 
-export { type OperationChain, buildQrCodeUrl, createDebounce, createOperationChain, formatAddressCityLast, formatDate, formatDateTime, formatPhoneNational, formatPhoneSpaced, getApiErrorMessage, getApiFieldErrors, getPhoneTelLink, pluralize, toDateInputValue, todayInTimezone };
+export { type DayScheduleInfo, type OperationChain, type SocialLink, type TodayScheduleInfo, buildQrCodeUrl, createDebounce, createOperationChain, formatAddressCityLast, formatDate, formatDateTime, formatPhoneNational, formatPhoneSpaced, formatScheduleStatus, getApiErrorMessage, getApiFieldErrors, getEmailLink, getPhoneTelLink, getSocialLinks, getTodayInfo, getWebsiteLink, getWeeklySchedule, pluralize, toDateInputValue, todayInTimezone };

package/dist/utils/index.js

@@ -1,4 +1,4 @@
-export { buildQrCodeUrl, createOperationChain, formatAddressCityLast, formatDate, formatDateTime, formatPhoneNational, formatPhoneSpaced, formatScheduleStatus, getApiErrorMessage, getApiFieldErrors, getEmailLink, getPhoneTelLink, getSocialLinks, getTodayInfo, getWebsiteLink, getWeeklySchedule, pluralize, toDateInputValue, todayInTimezone } from '../chunk-PJ2LEKW6.js';
+export { buildQrCodeUrl, createOperationChain, formatAddressCityLast, formatDate, formatDateTime, formatPhoneNational, formatPhoneSpaced, formatScheduleStatus, getApiErrorMessage, getApiFieldErrors, getEmailLink, getPhoneTelLink, getSocialLinks, getTodayInfo, getWebsiteLink, getWeeklySchedule, pluralize, toDateInputValue, todayInTimezone } from '../chunk-MZ66ARDL.js';
 export { createDebounce } from '../chunk-XUGXLJZB.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/website-settings/index.d.ts

@@ -1,6 +1,6 @@
 import { Media } from '@zenky/storefront-api';
 import { ZenkyIntegration } from '@zenky/integrations-sdk';
-import { a as SnippetGroup } from '../snippets-BC5bkSjm.js';
+import { SnippetGroup } from '../snippets/index.js';
 
 type SettingValue = string | number | boolean | null;
 interface WebsiteSettingsValues {

package/docs/consumer-setup.md

@@ -0,0 +1,279 @@
+# Consumer Setup
+
+This guide is for teams integrating `@zenky/storefront-vue` into a Vue or Nuxt
+storefront. The package owns reusable storefront state and business flows. The consumer
+owns framework glue, visual components, routing, server endpoints, and environment
+configuration.
+
+## 1. Install an exact version
+
+Use an exact version while integrating or testing a prerelease. Upgrade deliberately
+after the consumer quality gate is green.
+
+```bash
+npm install --save-exact @zenky/storefront-vue@0.10.4
+```
+
+The consumer must also provide compatible peer dependencies:
+
+```bash
+npm install vue@^3.5 pinia@^3 @zenky/storefront-api@^1
+```
+
+Install `@zenky/integrations-sdk` when the consumer sends Zenky integration events.
+
+Do not commit a `file:.yalc/...` dependency. `yalc` is only for local development; CI
+and deployed environments must install a published package version.
+
+## 2. Decide which domains the consumer needs
+
+Import public subpaths instead of application source files:
+
+```ts
+import { createStorefront } from '@zenky/storefront-vue'
+import { getRemoteCatalog } from '@zenky/storefront-vue/catalog'
+import { useProductPricing } from '@zenky/storefront-vue/products'
+import { useCartStore } from '@zenky/storefront-vue/stores'
+```
+
+A read-only menu normally needs `catalog`, `products`, `theme`, `utils`, and selected
+stores. It does not need cart, checkout, auth, delivery, or payment modules.
+
+A full storefront can additionally use `cart`, `order`, `promotions`, `seo`,
+`pagination`, `snippets`, and `website-settings`.
+
+Never import from `@zenky/storefront-vue/dist/*` or from this repository's `src/*`.
+Only documented package exports are public API.
+
+## 3. Create one composition root
+
+The consumer creates external adapters once and installs the storefront plugin after
+Pinia.
+
+```ts
+import { createApp } from 'vue'
+import { createPinia } from 'pinia'
+import { createStorefront } from '@zenky/storefront-vue'
+import type { StorefrontRuntime } from '@zenky/storefront-vue/ports'
+
+import App from './App.vue'
+import { sdk } from './services/zenky'
+
+const app = createApp(App)
+const pinia = createPinia()
+
+const runtime: StorefrontRuntime = {
+  sdk,
+  config: {
+    baseUrl: import.meta.env.VITE_STOREFRONT_URL,
+    baseAuthUrl: import.meta.env.VITE_AUTH_URL,
+    salesChannelId: import.meta.env.VITE_SALES_CHANNEL_ID || undefined,
+  },
+  storage: {
+    get: (key) => localStorage.getItem(key),
+    set: (key, value) => localStorage.setItem(key, value),
+    remove: (key) => localStorage.removeItem(key),
+  },
+  notifier: {
+    error: (message) => notifications.error(message),
+    success: (message) => notifications.success(message),
+    warning: (message) => notifications.warning(message),
+    message: (title, options) => notifications.message(title, options),
+  },
+  messages: {
+    format: (key, params) => i18n.t(key, params),
+  },
+  activity: {
+    begin: (kind) => busy.begin(kind),
+    end: (kind) => busy.end(kind),
+  },
+}
+
+app.use(pinia)
+app.use(createStorefront(runtime))
+app.mount('#app')
+```
+
+Use `NOOP_NOTIFIER` and `NOOP_ACTIVITY_REPORTER` from the `ports` subpath when a
+read-only consumer intentionally has no notifications or busy UI. Keep that decision
+explicit.
+
+## 4. Nuxt adapter
+
+Nuxt consumers should install the runtime in one plugin and keep Nuxt APIs in that
+plugin, not in the package.
+
+```ts
+import { createStorefront } from '@zenky/storefront-vue'
+import type { StorefrontRuntime } from '@zenky/storefront-vue/ports'
+
+export default defineNuxtPlugin((nuxtApp) => {
+  const config = useRuntimeConfig()
+
+  const runtime: StorefrontRuntime = {
+    sdk: useStorefrontApi(),
+    config: {
+      baseUrl: config.public.storefrontBaseUrl,
+      baseAuthUrl: config.public.storefrontAuthUrl,
+    },
+    storage: {
+      get: (key) => useCookie<string | null>(key).value ?? null,
+      set: (key, value, options) => {
+        useCookie<string>(key, options).value = value
+      },
+      remove: (key, options) => {
+        useCookie(key, options).value = null
+      },
+    },
+    notifier: createNotifierAdapter(),
+    messages: createMessageFormatter(),
+    activity: createActivityAdapter(),
+  }
+
+  nuxtApp.vueApp.use(createStorefront(runtime))
+})
+```
+
+Resolve optional integrations lazily when their initialization order is later than the
+storefront plugin:
+
+```ts
+runtime.events = {
+  get: () => useZenkyIntegrations(),
+}
+
+runtime.realtime = {
+  get: () => useRealtimeAdapter(),
+}
+```
+
+Do not capture an initial `null` integration instance during plugin setup.
+
+## 5. Storage and sensitive data
+
+The storage adapter is synchronous because order and auth credentials are read while
+composables are created.
+
+For browser-only applications, `localStorage` or cookies are acceptable according to
+the consumer's security model. For SSR, use request-scoped cookies.
+
+Never:
+
+- share in-memory storage between users;
+- log storage values, order tokens, API tokens, cookies, confirmation codes, payment
+  tokens, phone numbers, addresses, or order comments;
+- expose secret server configuration through public runtime config;
+- persist real credentials in test fixtures.
+
+See [Runtime Ports](ports.md) for the complete security boundary.
+
+## 6. SSR isolation
+
+For every server request, create a new:
+
+1. Vue application;
+2. Pinia instance;
+3. `StorefrontRuntime`;
+4. storage adapter.
+
+Do not keep runtime or Pinia instances in module-global server state. Runtime-owned
+mutation versions, request deduplication, restriction gates, and related-product state
+must not cross request or application boundaries.
+
+## 7. Local package development with yalc
+
+Use `yalc` only when changing the package and consumer together.
+
+In this repository:
+
+```bash
+npm run build
+npx yalc publish
+```
+
+In the consumer:
+
+```bash
+npx yalc add @zenky/storefront-vue
+```
+
+After another package change:
+
+```bash
+npm run build
+npx yalc push
+```
+
+Before committing the consumer:
+
+```bash
+npx yalc remove @zenky/storefront-vue
+npm install --save-exact @zenky/storefront-vue@<published-version>
+```
+
+Verify that `package.json` and `package-lock.json` no longer reference `.yalc`.
+
+## 8. Consumer quality gate
+
+Before requesting review:
+
+```bash
+npm ci
+npm run lint
+npm run test
+npm run build
+```
+
+For Nuxt consumers, also verify:
+
+- the first SSR request returns HTML without a storefront-runtime or Pinia error;
+- hydration completes without mismatch warnings;
+- a new browser session creates or restores the expected order;
+- a second app or SSR request does not see the first user's state;
+- optional integrations initialized after the runtime still receive events.
+
+For cart or checkout changes, cover:
+
+- add, increment, decrement, and clear;
+- API failures and stale responses;
+- delivery and payment selection;
+- minimum-order behavior;
+- product restrictions;
+- cleanup of busy state.
+
+## 9. Upgrade checklist
+
+1. Read the package changelog and migration notes.
+2. Install the exact target version.
+3. Review changed ports and exported types.
+4. Run the package consumer's unit tests and production build.
+5. Run smoke tests against a dedicated development store.
+6. Deploy to development.
+7. Run the same smoke suite against the deployed URL.
+8. Only then widen the version range or promote a prerelease.
+
+## 10. Common failures
+
+### `createStorefront() is not installed`
+
+The runtime plugin was not installed, was installed after a component used the package,
+or a second Vue application did not receive its own runtime.
+
+### `getActivePinia()` or `No active Pinia`
+
+Install Pinia before `createStorefront(runtime)` and before calling package stores.
+
+### The app builds locally but CI cannot install the package
+
+Check `package.json` and the lockfile for `file:.yalc`, local paths, or an unpublished
+version.
+
+### SSR users share cart or restriction state
+
+A runtime, Pinia instance, or storage adapter is being reused between requests. Make all
+three request-scoped.
+
+### An optional integration never receives events
+
+Provide a lazy `{ get() }` adapter instead of capturing the integration instance before
+it is initialized.

package/docs/ports.md

@@ -0,0 +1,148 @@
+# Runtime Ports
+
+`@zenky/storefront-vue` follows Ports & Adapters. Domain composables declare the external
+capabilities they need; a storefront supplies concrete adapters once at its composition
+root. This keeps the package portable across Vue SPA, Nuxt SSR, embedded menus, edge
+runtimes, tests, and future storefront templates.
+
+## Dependency direction
+
+```text
+Vue/Nuxt storefront ── creates adapters ──▶ StorefrontRuntime
+                                              │
+UI/components ── call composables ──▶ domain logic ── calls ports ──▶ Zenky SDK/services
+```
+
+The core may know a port interface. It must not know which router, cookie library, toast
+system, WebSocket provider, analytics vendor, or server framework implements that port.
+
+## Runtime contract
+
+Install one runtime per Vue application:
+
+```ts
+import { createStorefront } from '@zenky/storefront-vue'
+import type { StorefrontRuntime } from '@zenky/storefront-vue/ports'
+
+const runtime: StorefrontRuntime = {
+  sdk,
+  config: {
+    baseUrl: 'https://shop.example.com',
+    baseAuthUrl: 'https://auth.example.com',
+    salesChannelId: 'web',
+  },
+  storage,
+  notifier,
+  messages,
+  activity,
+}
+
+app.use(pinia)
+app.use(createStorefront(runtime))
+```
+
+For a locally isolated widget, `provideStorefront(runtime)` can be called inside its setup
+scope instead of installing the plugin globally.
+
+## Required ports
+
+| Port | Contract | Responsibility |
+| --- | --- | --- |
+| `sdk` | `ZenkyStorefront` | Typed access to Zenky Storefront API resources. The consumer owns configuration and request transport. |
+| `config` | `StorefrontConfig` | Public storefront and auth base URLs plus an optional sales channel id. |
+| `storage` | `StorageAdapter` | Synchronous key/value persistence used for order/auth state and lightweight preferences. |
+| `notifier` | `Notifier` | User-facing `error`, `success`, `warning`, and generic message notifications. |
+| `messages` | `MessageFormatter` | Maps stable domain message keys and parameters to localized consumer copy. |
+| `activity` | `ActivityReporter` | Balanced `begin(kind)` / `end(kind)` signals for long-running operations. |
+
+Required ports are intentionally small. If an application has no UI for notifications or
+activity, use `NOOP_NOTIFIER` and `NOOP_ACTIVITY_REPORTER` explicitly.
+For tests that do not render messages, use `KEY_MESSAGE_FORMATTER`. Production consumers
+should provide a locale-aware formatter.
+
+## Optional ports
+
+| Port | Contract | Behavior when absent |
+| --- | --- | --- |
+| `events` | Lazy `EventsPort.get()` returning `ZenkyIntegrationsSDK` | Integration events are skipped. |
+| `realtime` | Lazy `RealtimePort.get()` returning `RealtimeAdapter` | Realtime order updates are skipped. |
+| `catalogReloader` | `CatalogReloader.reload()` | Stock changes do not trigger an external catalog reload. |
+| `rum` | `RumReporter.mark()` / `measure()` | Performance instrumentation is skipped. |
+| `commerceEvents` | Commerce tracking plus anonymous/session identity | Commerce events and checkout identity enrichment are skipped. |
+
+`events` and `realtime` are providers rather than captured values because integrations can
+be initialized after the storefront runtime. The core resolves them at the moment an event
+is emitted or a subscription is needed.
+
+## Storage adapter
+
+The adapter is synchronous because cart credentials are needed while composables are being
+created. Browser applications can wrap cookies or `localStorage`; SSR applications should
+wrap request/response cookies. `createMemoryStorage()` is intended for tests and isolated,
+request-scoped SSR work only.
+
+```ts
+import type { StorageAdapter } from '@zenky/storefront-vue/ports'
+
+export function createCookieStorage(cookies: CookieStore): StorageAdapter {
+  return {
+    get: (key) => cookies.get(key) ?? null,
+    set: (key, value, options) => {
+      cookies.set(key, value, {
+        path: options?.path ?? '/',
+        maxAge: options?.maxAge,
+        sameSite: options?.sameSite ?? 'lax',
+        secure: options?.secure ?? true,
+      })
+    },
+    remove: (key, options) => cookies.remove(key, { path: options?.path ?? '/' }),
+  }
+}
+```
+
+Do not use one in-memory adapter across users. Do not log storage values. Where the host
+framework permits it, prefer secure, same-site cookies and narrowly scoped paths. Whether a
+cookie can be `httpOnly` depends on where the browser-side SDK needs access to the value.
+
+## SSR and multi-app isolation
+
+For every SSR request, create all three together:
+
+1. a new Pinia instance;
+2. a new `StorefrontRuntime` with request-scoped adapters;
+3. a new Vue application using those instances.
+
+Runtime-owned mutation versions, request deduplication, and related-product state are held
+per runtime. Reusing a runtime or Pinia across requests defeats that isolation and can leak
+state between users.
+
+Public entries are verified by CI through an import in a Node environment without browser
+globals. Built output is also rejected if it contains CommonJS, Node built-in imports,
+`Buffer`, or `process` references. Browser-only actions such as online-payment retry either
+guard `window` access or accept the required URL from the consumer.
+
+## Security boundary
+
+Ports can carry sensitive data even when their types look generic. Adapter implementations
+must not log complete requests, orders, storage records, analytics payloads, or errors from
+unknown SDK transports. The cart/checkout logger redacts common credential shapes as a
+second line of defense, but callers should still pass allow-listed context such as
+`orderId`, operation kind, counts, and booleans.
+
+Never put these values in diagnostic context:
+
+- order or API tokens;
+- `Authorization` and `Cookie` headers;
+- reCAPTCHA payloads and confirmation codes;
+- payment/card token identifiers;
+- customer names, phones, addresses, or free-form order comments.
+
+## Adding or changing a port
+
+Before adding a port, verify that the capability cannot be represented by an existing one.
+Keep the interface vendor-neutral and minimal, document absence/failure behavior, provide a
+no-op implementation when that behavior is meaningful, and add an isolation test.
+
+Adding an optional method is usually backward-compatible. Adding a required port or method,
+changing semantics, or widening when sensitive data is emitted is a breaking change and
+requires a major-version release note.

package/docs/releasing.md

@@ -0,0 +1,53 @@
+# Release Process
+
+Releases are driven by GitHub Releases. Source control keeps
+`"version": "0.0.0-development"`; the publish workflow derives the immutable npm version
+from the release tag.
+
+## Before creating a release
+
+1. Confirm all required CI checks pass on `master`.
+2. Review Dependabot and security alerts.
+3. Move relevant `Unreleased` changelog entries into a new `X.Y.Z - YYYY-MM-DD` section.
+4. Choose the version using Semantic Versioning:
+   - patch for compatible fixes and security hardening;
+   - minor for backward-compatible public features;
+   - major for breaking exports, port contracts, behavior, or support changes.
+
+   While the package is below `1.0.0`, SemVer does not reserve any component for
+   stability ([SemVer §4](https://semver.org/spec/v2.0.0.html#spec-item-4)). A breaking
+   release may stay inside the current `0.x.y` range when every consumer is known and
+   migrated in the same change. State it explicitly at the top of the changelog section
+   and write the migration steps. Once `1.0.0` ships, the table above is binding.
+5. Verify migrations and compatibility notes are explicit for any consumer-visible change.
+6. Update the version referenced in `docs/consumer-setup.md` to the one being released.
+7. Run `npm run check:release` and inspect `npm pack --dry-run` locally.
+
+## Publish
+
+1. Create a GitHub Release for the exact commit to publish.
+2. Tag it `vX.Y.Z`; prereleases may use `vX.Y.Z-beta.N` or `vX.Y.Z-rc.N`.
+3. Generate release notes, then edit them into a consumer-focused summary: outcome first,
+   migrations second, implementation detail last.
+4. Publish the GitHub Release.
+
+The workflow validates the tag, installs with `npm ci`, injects the tag version without
+creating a Git commit, runs the release quality gate, checks package contents, and publishes
+through npm trusted publishing. Stable versions receive the `latest` dist-tag; prereleases
+receive `next`.
+
+The npm package must have a trusted publisher configured for this GitHub repository and the
+`publish-npm.yml` workflow. No long-lived `NPM_TOKEN` should be added.
+
+## Verify
+
+- Confirm the workflow completed and the package has npm provenance.
+- Inspect `npm view @zenky/storefront-vue@X.Y.Z` metadata and dist-tags.
+- Install the exact version into a clean consumer and import both the root and one subpath.
+- Confirm the GitHub release links to the correct tag and changelog section.
+
+## Recovery
+
+Never reuse or move a published version tag. npm versions are immutable. If a release is
+bad, deprecate it with a clear message, fix forward, and publish a new patch or prerelease.
+Reserve unpublishing for exceptional security/legal cases and follow npm policy.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zenky/storefront-vue",
-    "version": "0.10.0",
+    "version": "0.10.4",
     "description": "Zenky Storefront SDK for Vue 3.",
     "keywords": [
         "zenky",
@@ -12,11 +12,21 @@
     ],
     "author": "Zenky",
     "license": "MIT",
+    "homepage": "https://github.com/zenky/storefront-vue#readme",
+    "bugs": {
+        "url": "https://github.com/zenky/storefront-vue/issues"
+    },
+    "engines": {
+        "node": ">=20.19.0",
+        "npm": ">=10"
+    },
     "type": "module",
     "sideEffects": false,
     "files": [
         "dist",
+        "docs",
         "README.md",
+        "CHANGELOG.md",
         "LICENSE.md"
     ],
     "exports": {
@@ -60,10 +70,6 @@
             "types": "./dist/seo/index.d.ts",
             "import": "./dist/seo/index.js"
         },
-        "./layout": {
-            "types": "./dist/layout/index.d.ts",
-            "import": "./dist/layout/index.js"
-        },
         "./pagination": {
             "types": "./dist/pagination/index.d.ts",
             "import": "./dist/pagination/index.js"
@@ -89,23 +95,36 @@
     "scripts": {
         "build": "tsup",
         "dev": "tsup --watch",
+        "format": "biome format --write .",
+        "format:check": "biome format .",
+        "lint": "biome lint .",
+        "lint:fix": "biome lint --write .",
         "typecheck": "tsc --noEmit",
         "test": "vitest run",
+        "test:coverage": "vitest run --coverage",
         "test:watch": "vitest",
         "check:exports": "publint --strict && attw --pack . --profile esm-only",
-        "prepublishOnly": "npm run typecheck && npm run test && npm run build && npm run check:exports"
+        "check:boundaries": "node scripts/check-boundaries.mjs",
+        "check:runtime": "node scripts/check-runtime-compat.mjs",
+        "check:size": "node scripts/check-bundle-size.mjs",
+        "check": "npm run format:check && npm run lint && npm run typecheck && npm run test && npm run check:boundaries && npm run build && npm run check:exports && npm run check:runtime && npm run check:size",
+        "check:ci": "npm run format:check && npm run lint && npm run typecheck && npm run test:coverage && npm run check:boundaries && npm run build && npm run check:exports && npm run check:runtime && npm run check:size",
+        "check:release": "npm run typecheck && npm run test && npm run check:boundaries && npm run build && npm run check:exports && npm run check:runtime && npm run check:size",
+        "prepublishOnly": "npm run check:release"
     },
     "peerDependencies": {
         "@zenky/integrations-sdk": ">=0.1.3",
-        "@zenky/storefront-api": ">=0.0.64",
+        "@zenky/storefront-api": "^1.0.1",
         "pinia": "^3.0.0",
         "vue": "^3.5.0"
     },
     "devDependencies": {
         "@arethetypeswrong/cli": "^0.18.2",
+        "@biomejs/biome": "^2.5.5",
         "@types/node": "^22.10.0",
+        "@vitest/coverage-v8": "^4.1.10",
         "@zenky/integrations-sdk": "^0.1.3",
-        "@zenky/storefront-api": "^0.0.64",
+        "@zenky/storefront-api": "^1.0.1",
         "pinia": "^3.0.4",
         "publint": "^0.3.21",
         "tsup": "^8.3.5",

package/dist/chunk-2OD7CLKD.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/catalog/findCategory.ts","../src/catalog/groupBySubcategory.ts","../src/catalog/useCollections.ts","../src/catalog/routes.ts"],"names":[],"mappings":"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","file":"chunk-2OD7CLKD.js","sourcesContent":["import type { NestedCategory } from '@zenky/storefront-api'\n\n/**\n * Рекурсивный поиск категории в дереве по `short_id`.\n *\n * `NestedCategory[]` — это дерево: корневые категории на верхнем уровне,\n * вложенные — внутри `children[]`. Простой `tree.find()` найдёт только\n * корневые. Для вложенных (например «Куртки» внутри «Мужская» внутри «Одежда»)\n * нужно рекурсивно обойти все ветки.\n *\n * Возвращает первое совпадение (DFS pre-order).\n */\nexport function findCategoryByShortId(\n    tree: NestedCategory[],\n    shortId: string\n): NestedCategory | null {\n    for (const cat of tree) {\n        if (cat.short_id === shortId) return cat\n        if (cat.children && cat.children.length > 0) {\n            const found = findCategoryByShortId(cat.children, shortId)\n            if (found) return found\n        }\n    }\n    return null\n}\n\n/**\n * Находит корневого предка категории по `parent_id`.\n *\n * Для вложенной «Куртки» (parent: «Мужская») вернёт «Одежда» (корень ветки).\n * Для корневой «Одежда» вернёт саму себя.\n *\n * Используется в `CategoryTabs`, чтобы подсветить корневой таб когда юзер\n * находится на вложенной категории.\n */\nexport function findRootAncestor(\n    tree: NestedCategory[],\n    category: NestedCategory\n): NestedCategory | null {\n    if (!category.parent_id) {\n        // Уже корневая — возвращаем её саму если она есть в tree на верхнем уровне\n        return tree.find((c) => c.id === category.id) ?? category\n    }\n\n    // Ищем родителя\n    const parent = findCategoryById(tree, category.parent_id)\n    if (!parent) return null\n    return findRootAncestor(tree, parent)\n}\n\n/** Рекурсивный поиск по `id` (не `short_id`). Используется в findRootAncestor. */\nexport function findCategoryById(tree: NestedCategory[], id: string): NestedCategory | null {\n    for (const cat of tree) {\n        if (cat.id === id) return cat\n        if (cat.children && cat.children.length > 0) {\n            const found = findCategoryById(cat.children, id)\n            if (found) return found\n        }\n    }\n    return null\n}\n\n/**\n * Возвращает путь от корневой категории до указанной (включительно).\n *\n * Пример для «Куртки» в ветке «Одежда → Мужская → Куртки»:\n *   → [Одежда, Мужская, Куртки]\n *\n * Используется для построения хлебных крошек.\n */\nexport function getCategoryPath(\n    tree: NestedCategory[],\n    target: NestedCategory\n): NestedCategory[] {\n    const path: NestedCategory[] = []\n    let current: NestedCategory | null = target\n\n    while (current) {\n        path.unshift(current)\n        if (!current.parent_id) break\n        current = findCategoryById(tree, current.parent_id)\n    }\n\n    return path\n}\n","import type { NestedCategory, Product } from '@zenky/storefront-api'\n\nexport interface SubcategoryGroup {\n    category: NestedCategory\n    products: Product[]\n}\n\nexport interface GroupedProducts {\n    rootDirect: Product[]\n    groups: SubcategoryGroup[]\n}\n\nexport function collectDescendantIds(category: NestedCategory): string[] {\n    const ids = [category.id]\n    for (const child of category.children ?? []) ids.push(...collectDescendantIds(child))\n    return ids\n}\n\nfunction productCategoryIds(product: Product): string[] {\n    const categories = (product as unknown as { categories?: Array<{ id: string }> }).categories\n    return categories?.map((c) => c.id) ?? []\n}\n\n/**\n * Товары поддерева в порядке дерева (DFS): сперва товары самой категории\n * (в порядке каталога), затем рекурсивно товары дочерних категорий.\n * Дубли (товар в нескольких категориях) отбрасываем, оставляя первое вхождение.\n */\nfunction collectSubtreeProducts(\n    category: NestedCategory,\n    products: Product[],\n    order: Map<string, number>\n): Product[] {\n    const seen = new Set<string>()\n    const out: Product[] = []\n\n    const pushUnique = (list: Product[]): void => {\n        for (const p of list) {\n            if (!seen.has(p.id)) {\n                seen.add(p.id)\n                out.push(p)\n            }\n        }\n    }\n\n    pushUnique(\n        products\n            .filter((p) => productCategoryIds(p).includes(category.id))\n            .sort((a, b) => (order.get(a.id) ?? 0) - (order.get(b.id) ?? 0))\n    )\n    for (const child of category.children ?? []) {\n        pushUnique(collectSubtreeProducts(child, products, order))\n    }\n\n    return out\n}\n\nexport function groupProductsBySubcategory(\n    rootCategory: NestedCategory,\n    products: Product[]\n): GroupedProducts {\n    const order = new Map(products.map((p, i) => [p.id, i]))\n\n    const rootDirect = products.filter((p) => productCategoryIds(p).includes(rootCategory.id))\n\n    const groups: SubcategoryGroup[] = []\n    for (const child of rootCategory.children ?? []) {\n        const groupProducts = collectSubtreeProducts(child, products, order)\n        if (groupProducts.length > 0) groups.push({ category: child, products: groupProducts })\n    }\n\n    return { rootDirect, groups }\n}\n","import type { CollectionsListRequest, ProductsCollection, ZenkyStorefront } from '@zenky/storefront-api'\n\n/**\n * Загрузка списка коллекций товаров магазина.\n * Pure composable — SDK передаётся параметром (DI), Nuxt не нужен.\n *\n * NOTE: одиночный `getCollection(id)` в storefront API не предусмотрен,\n * для получения товаров коллекции используется `GET /products?collection_id=...`.\n * Чтобы получить метаданные коллекции — ищем в списке через `loadCollections`.\n */\nexport function useCollections(sdk: ZenkyStorefront): {\n    loadCollections: (\n        storeId: string,\n        request?: CollectionsListRequest\n    ) => Promise<ProductsCollection[]>\n} {\n    async function loadCollections(\n        storeId: string,\n        request?: CollectionsListRequest\n    ): Promise<ProductsCollection[]> {\n        const response = await sdk.collections.getCollections(storeId, request)\n        return response.items\n    }\n\n    return { loadCollections }\n}\n","/** URL-хелперы каталога — единая точка правды для путей категорий/коллекций. */\nexport const catalogRoutes = {\n    /** Корневая страница каталога: список категорий + коллекций */\n    index: (): string => '/catalog',\n\n    /** Страница конкретной категории */\n    category: (shortId: string, slug: string | null): string =>\n        `/catalog/${shortId}/${slug || shortId}`,\n\n    /** Страница конкретной коллекции */\n    collection: (id: string): string => `/collections/${id}`,\n} as const\n"]}