@laconius/core 0.1.0

package/lib/typescript/src/config.d.ts

@@ -0,0 +1,150 @@
+import type { ComponentType } from 'react';
+import type { QueryClient } from '@tanstack/react-query';
+import type { SiteContextAdapter } from './site-context.js';
+/**
+ * An endpoint value is a URL template, optionally split into named scopes.
+ * Values carry their own query string (`fields=…`); the builder merges caller params into it.
+ */
+export type EndpointValue = string | Record<string, string>;
+/**
+ * Endpoint keys. Feature packages add their own by declaration merging:
+ *
+ * ```ts
+ * declare module '@laconius/core' {
+ *   interface LaconiusEndpoints { productSearch: string | Record<'default' | 'carousel', string> }
+ * }
+ * ```
+ */
+export interface LaconiusEndpoints {
+    baseSites: string;
+    languages: string;
+    currencies: string;
+    countries: string;
+    regions: string;
+}
+/** Converter keys, extended by declaration merging exactly like endpoint keys. */
+export interface LaconiusConverters {
+    baseSite: unknown;
+    language: unknown;
+    currency: unknown;
+    country: unknown;
+    region: unknown;
+}
+/** Adapter slots, extended by declaration merging. Replacing one is the route to a non-OCC backend. */
+export interface LaconiusAdapters {
+    siteContext: SiteContextAdapter;
+}
+export type TranslationTree = {
+    [key: string]: string | TranslationTree;
+};
+/** Extended by `@laconius/ui` with themes, components and colour scheme. */
+export interface LaconiusUiConfig {
+    media?: {
+        /** Format code to width in pixels. Widths, not device classes. */
+        formats?: Record<string, number>;
+        /** Role to the largest format code that role may use. */
+        roles?: Record<string, string>;
+    };
+}
+/** Extended by `@laconius/cms` with the component registry and layout config. */
+export interface LaconiusCmsConfig {
+    htmlRenderer?: ComponentType<{
+        html: string;
+    }>;
+}
+export interface LaconiusAuthConfig {
+    clientId: string;
+    redirectUri: string;
+    authServerUrl: string;
+    /** Passed to `expo-secure-store` as `requireAuthentication`. Off by default. */
+    requireBiometricUnlock?: boolean;
+    /** Identity-provider slot. Laconius stores and refreshes whatever it is handed. */
+    tokenProvider?: () => Promise<{
+        access_token: string;
+        refresh_token?: string;
+        expires_in: number;
+    }>;
+    /** Multisite isolation hook, replacing Spartacus' `AuthMultisiteIsolationService`. */
+    decorateUserId?: (userId: string, baseSite: string) => string;
+    /** Called when the session dies. Core never navigates. */
+    onAuthExpired?: () => void;
+}
+export interface LaconiusConfig {
+    backend: {
+        occ: {
+            baseUrl: string;
+            baseSite: string;
+            /** Defaults to `/occ/v2`. */
+            prefix?: string;
+            endpoints?: Partial<LaconiusEndpoints>;
+        };
+        media?: {
+            baseUrl?: string;
+        };
+        adapters?: Partial<LaconiusAdapters>;
+    };
+    auth: LaconiusAuthConfig;
+    context: {
+        languages: string[];
+        currencies: string[];
+        defaultLanguage?: string;
+        defaultCurrency?: string;
+    };
+    /** The three known version-gated endpoints. Defaults are the 221121.x baseline. */
+    capabilities?: {
+        jsonVouchers?: boolean;
+        productAvailabilities?: boolean;
+        userScopedCms?: boolean;
+    };
+    converters?: Partial<Record<keyof LaconiusConverters, unknown[]>>;
+    cms?: LaconiusCmsConfig;
+    ui?: LaconiusUiConfig;
+    i18n?: {
+        fallbackLanguage?: string;
+        translations?: Record<string, TranslationTree>;
+        /** Set this and Laconius resolves nothing itself. */
+        translate?: (key: string, params?: Record<string, unknown>) => string;
+    };
+    query?: {
+        queryClient?: QueryClient;
+        wireOnlineManager?: boolean;
+        wireFocusManager?: boolean;
+    };
+    /** Observation only: it does not render. */
+    onError?: (error: unknown, ctx: {
+        url?: string;
+    }) => void;
+}
+type Primitive = string | number | boolean | symbol | bigint | null | undefined;
+export type DeepPartial<T> = T extends Primitive ? T : T extends (...args: never[]) => unknown ? T : T extends readonly (infer _U)[] ? T : {
+    [K in keyof T]?: DeepPartial<T[K]>;
+};
+/** What a feature package exports as `defaultProductConfig` and friends. */
+export type LaconiusConfigChunk = DeepPartial<LaconiusConfig>;
+/** The app's own chunk. `backend.occ` and `auth` are what the provider refuses to start without. */
+export type LaconiusAppConfig = LaconiusConfigChunk & {
+    backend: DeepPartial<LaconiusConfig['backend']> & {
+        occ: {
+            baseUrl: string;
+            baseSite: string;
+        };
+    };
+    auth: LaconiusAuthConfig;
+};
+export declare const DEFAULT_OCC_PREFIX = "/occ/v2";
+export declare const defaultCapabilities: {
+    jsonVouchers: boolean;
+    productAvailabilities: boolean;
+    userScopedCms: boolean;
+};
+/**
+ * Objects deep-merge, arrays are replaced, `undefined` is ignored.
+ *
+ * Arrays are never concatenated: a default you cannot remove is a bug. Everything that would
+ * want concatenation exports a `default*` array the app spreads explicitly.
+ */
+export declare function deepMerge<T>(base: T, override: unknown): T;
+/** @internal Use `createLaconiusConfig`, which seeds core's own defaults first. */
+export declare function createLaconiusConfigInternal(app: LaconiusAppConfig, chunks: LaconiusConfigChunk[]): LaconiusConfig;
+export {};
+//# sourceMappingURL=config.d.ts.map

package/lib/typescript/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/config.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/converters.d.ts

@@ -0,0 +1,17 @@
+import type { LaconiusConfig, LaconiusConverters } from './config.js';
+/** Spartacus' populator pattern with dependency injection removed. */
+export type Converter<S, T> = (source: S, target?: T) => T;
+/**
+ * Reduces a converter stack so each converter enriches the previous one's partial target.
+ *
+ * The seed is explicit because it is easy to re-derive wrong: an empty stack returns the source
+ * unchanged, and otherwise the first converter is called with `target === undefined`.
+ */
+export declare function applyConverters<S, T>(source: S, converters: readonly Converter<S, T>[] | undefined): T;
+export type ConverterRegistry = {
+    convert<S, T>(source: S, key: keyof LaconiusConverters): T;
+    convertAll<S, T>(sources: S[] | undefined, key: keyof LaconiusConverters): T[];
+};
+/** Converters are registered by explicit spread of a feature's exported defaults. */
+export declare function createConverterRegistry(config: LaconiusConfig): ConverterRegistry;
+//# sourceMappingURL=converters.d.ts.map

package/lib/typescript/src/converters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converters.d.ts","sourceRoot":"","sources":["../../../src/converters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,aAAU,CAAC;AAEnE,sEAAsE;AACtE,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,CAAC,EAClC,MAAM,EAAE,CAAC,EACT,UAAU,EAAE,SAAS,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,SAAS,GACjD,CAAC,CAQH;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,kBAAkB,GAAG,CAAC,CAAC;IAC3D,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,kBAAkB,GAAG,CAAC,EAAE,CAAC;CAChF,CAAC;AAEF,qFAAqF;AACrF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,GACrB,iBAAiB,CAcnB"}

package/lib/typescript/src/create-config.d.ts

@@ -0,0 +1,11 @@
+import { type LaconiusAppConfig, type LaconiusConfig, type LaconiusConfigChunk } from './config.js';
+/** What core contributes before any feature chunk: its endpoints, media table and strings. */
+export declare const coreDefaults: LaconiusConfigChunk;
+/**
+ * Deep-merges core's defaults, then the feature chunks in order, then the app chunk last, so an
+ * override is written where the reader expects it.
+ *
+ * Objects deep-merge, arrays are replaced, `undefined` is ignored.
+ */
+export declare function createLaconiusConfig(app: LaconiusAppConfig, featureChunks?: LaconiusConfigChunk[]): LaconiusConfig;
+//# sourceMappingURL=create-config.d.ts.map

package/lib/typescript/src/create-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-config.d.ts","sourceRoot":"","sources":["../../../src/create-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,aAAU,CAAC;AAKlB,8FAA8F;AAC9F,eAAO,MAAM,YAAY,EAAE,mBAI1B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,iBAAiB,EACtB,aAAa,GAAE,mBAAmB,EAAO,GACxC,cAAc,CAEhB"}

package/lib/typescript/src/endpoints.d.ts

@@ -0,0 +1,36 @@
+import { type EndpointValue, type LaconiusConfig, type LaconiusEndpoints } from './config.js';
+/**
+ * Core's own endpoints: site context. Every value is a URL with its query string, never a bare
+ * path, so field selection lives in the template rather than at the call site.
+ *
+ * `baseSites` is the one endpoint built without the base-site segment.
+ */
+export declare const defaultCoreEndpoints: Pick<LaconiusEndpoints, 'baseSites' | 'languages' | 'currencies' | 'countries' | 'regions'>;
+export type EndpointParams = {
+    /** Values for `${placeholder}` segments in the template. URI-encoded on interpolation. */
+    urlParams?: Record<string, string | number>;
+    /** Merged into the query string the template already carries. Caller params win. */
+    queryParams?: Record<string, string | number | boolean | undefined>;
+};
+/**
+ * Named scope -> `default` scope -> plain string -> `undefined`.
+ *
+ * Spartacus' final fallback — using the endpoint key itself as the path — is deliberately
+ * dropped: it turns a configuration mistake into a mysterious 404.
+ */
+export declare function resolveEndpointValue(endpoints: Partial<Record<string, EndpointValue>>, key: string, scope?: string): string | undefined;
+/**
+ * Merges `queryParams` into the query string the template already carries, caller wins.
+ *
+ * Template values are kept verbatim — an OCC `fields` expression is already in the shape the
+ * backend wants, and re-encoding its parentheses breaks it.
+ */
+export declare function mergeQueryString(template: string, queryParams?: Record<string, string | number | boolean | undefined>): string;
+export type EndpointResolver = {
+    /** Full URL for an endpoint key. Throws an error naming the key when it is not configured. */
+    getEndpoint(key: string, params?: EndpointParams, scope?: string): string;
+    /** Lets an adapter branch on presence instead of crashing. */
+    isConfigured(key: string, scope?: string): boolean;
+};
+export declare function createEndpointResolver(config: LaconiusConfig): EndpointResolver;
+//# sourceMappingURL=endpoints.d.ts.map

package/lib/typescript/src/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../../src/endpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACvB,MAAM,aAAU,CAAC;AAElB;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,IAAI,CACrC,iBAAiB,EACjB,WAAW,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,CAOnE,CAAC;AAKF,MAAM,MAAM,cAAc,GAAG;IAC3B,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC5C,oFAAoF;IACpF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;CACrE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,EACjD,GAAG,EAAE,MAAM,EACX,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,GAAG,SAAS,CAMpB;AAiBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,WAAW,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAM,GACtE,MAAM,CAqBR;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,8FAA8F;IAC9F,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1E,8DAA8D;IAC9D,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACpD,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,gBAAgB,CA0B/E"}

package/lib/typescript/src/errors.d.ts

@@ -0,0 +1,43 @@
+/** One entry of OCC's `errors[]` envelope. `type` is open-ended and customer-extensible. */
+export type OccError = {
+    type?: string;
+    reason?: string;
+    subject?: string;
+    subjectType?: string;
+    message?: string;
+};
+/**
+ * The one error type Laconius throws for a failed request.
+ *
+ * An OCC business error is data, not a status code: `InsufficientStockError` and a network
+ * timeout are the same `status` to a shopper who needs to be told different things.
+ */
+export declare class LaconiusHttpError extends Error {
+    /** 0 when the request never reached the server. */
+    readonly status: number;
+    readonly url: string;
+    /** Parsed `errors[]`, empty when the payload carried none. */
+    readonly occErrors: OccError[];
+    /** Raw payload, for the app's telemetry. */
+    readonly body?: unknown;
+    constructor(init: {
+        status: number;
+        url: string;
+        occErrors?: OccError[];
+        body?: unknown;
+        message?: string;
+    });
+}
+/** Parses OCC's `errors[]` envelope out of an arbitrary payload. */
+export declare function parseOccErrors(body: unknown): OccError[];
+/** `getOccError(error)` for the first one, `getOccError(error, 'InsufficientStockError')` to match. */
+export declare function getOccError(error: unknown, type?: string): OccError | undefined;
+/**
+ * A translated sentence for a shopper:
+ * OCC `type`/`reason` -> OCC `type` -> status class -> unknown.
+ *
+ * Never falls through to a raw backend string: that leaks internals and is untranslated by
+ * definition.
+ */
+export declare function getErrorMessage(error: unknown, t: (key: string, params?: Record<string, unknown>) => string): string;
+//# sourceMappingURL=errors.d.ts.map

package/lib/typescript/src/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAC;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEZ,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;QACvB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CAaF;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,EAAE,CAOxD;AAED,uGAAuG;AACvG,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,QAAQ,GAAG,SAAS,CAItB;AAUD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,GAC3D,MAAM,CAoBR"}

package/lib/typescript/src/i18n.d.ts

@@ -0,0 +1,20 @@
+import type { TranslationTree } from './config.js';
+/** Dotted lookup into a nested translation chunk. */
+export declare function lookupKey(tree: TranslationTree | undefined, key: string): string | undefined;
+export declare function interpolate(template: string, params?: Record<string, unknown>): string;
+export type Translator = (key: string, params?: Record<string, unknown>) => string;
+/**
+ * Key lookup, `{{param}}` interpolation and `Intl.PluralRules` — the three things Laconius
+ * needs from an i18n runtime, in place of taking one as a peer dependency.
+ *
+ * A missing key returns the key itself: warned once in development, silent in production.
+ * A blank label is invisible; a printed key is a bug report.
+ */
+export declare function createTranslator(options: {
+    translations?: Record<string, TranslationTree>;
+    language: string;
+    fallbackLanguage?: string;
+    /** An app that already runs an i18n runtime sets this, and Laconius resolves nothing itself. */
+    translate?: Translator;
+}): Translator;
+//# sourceMappingURL=i18n.d.ts.map

package/lib/typescript/src/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAU,CAAC;AAsBhD,qDAAqD;AACrD,wBAAgB,SAAS,CACvB,IAAI,EAAE,eAAe,GAAG,SAAS,EACjC,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAQpB;AAaD,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACnC,MAAM,CAKR;AAED,MAAM,MAAM,UAAU,GAAG,CACvB,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC7B,MAAM,CAAC;AAEZ;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gGAAgG;IAChG,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB,GAAG,UAAU,CAgCb"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,17 @@
+export { DEFAULT_OCC_PREFIX, deepMerge, defaultCapabilities, type DeepPartial, type EndpointValue, type LaconiusAdapters, type LaconiusAppConfig, type LaconiusAuthConfig, type LaconiusCmsConfig, type LaconiusConfig, type LaconiusConfigChunk, type LaconiusConverters, type LaconiusEndpoints, type LaconiusUiConfig, type TranslationTree, } from './config.js';
+export { coreDefaults, createLaconiusConfig } from './create-config.js';
+export { createEndpointResolver, defaultCoreEndpoints, mergeQueryString, resolveEndpointValue, type EndpointParams, type EndpointResolver, } from './endpoints.js';
+export { createHttpClient, type LaconiusHttpClient, type LaconiusRequest, } from './client.js';
+export { LaconiusHttpError, getErrorMessage, getOccError, parseOccErrors, type OccError, } from './errors.js';
+export { SecureStorageError, createAuthClient, createDiscovery, type AuthClient, type TokenSet, } from './auth.js';
+export { singleFlight } from './single-flight.js';
+export { resolveCurrency, resolveLanguage, selectUserId, useSessionStore, useSiteContextStore, type SessionState, type SiteContextState, } from './stores.js';
+export { applyConverters, createConverterRegistry, type Converter, type ConverterRegistry, } from './converters.js';
+export { absolutizeMedia, defaultMediaFormats, defaultMediaRoles, getFormatsUpToMaxFormat, getGalleryImages, getMediaBaseUrl, getPrimaryImage, normalizeImages, resolveMediaCandidates, resolveMediaUrl, sortFormats, type MediaContainer, type MediaSource, } from './media.js';
+export { createTranslator, interpolate, lookupKey, type Translator, } from './i18n.js';
+export { defaultCoreTranslations } from './translations.js';
+export { getRuntime, laconiusQueryKey, setActiveRuntime, type LaconiusRuntime, } from './runtime.js';
+export { defaultSiteContextAdapter, siteContextQueries, useBaseSites, useCurrencies, useLanguages, type SiteContextAdapter, } from './site-context.js';
+export { LaconiusProvider, createDefaultQueryClient, useIsLoggedIn, useIsOnline, useLaconius, useLaconiusConfig, useLogout, useSiteContext, useTranslation, type LaconiusProviderProps, } from './provider.js';
+export type * from './models.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,mBAAmB,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,eAAe,GACrB,MAAM,aAAU,CAAC;AAClB,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,oBAAiB,CAAC;AAErE,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,gBAAgB,GACtB,MAAM,gBAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,eAAe,GACrB,MAAM,aAAU,CAAC;AAElB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,WAAW,EACX,cAAc,EACd,KAAK,QAAQ,GACd,MAAM,aAAU,CAAC;AAElB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,KAAK,UAAU,EACf,KAAK,QAAQ,GACd,MAAM,WAAQ,CAAC;AAEhB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAiB,CAAC;AAE/C,OAAO,EACL,eAAe,EACf,eAAe,EACf,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,KAAK,YAAY,EACjB,KAAK,gBAAgB,GACtB,MAAM,aAAU,CAAC;AAElB,OAAO,EACL,eAAe,EACf,uBAAuB,EACvB,KAAK,SAAS,EACd,KAAK,iBAAiB,GACvB,MAAM,iBAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,uBAAuB,EACvB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,YAAS,CAAC;AAEjB,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,KAAK,UAAU,GAChB,MAAM,WAAQ,CAAC;AAChB,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAgB,CAAC;AAEzD,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,eAAe,GACrB,MAAM,cAAW,CAAC;AAEnB,OAAO,EACL,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,KAAK,kBAAkB,GACxB,MAAM,mBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,aAAa,EACb,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,SAAS,EACT,cAAc,EACd,cAAc,EACd,KAAK,qBAAqB,GAC3B,MAAM,eAAY,CAAC;AAEpB,mBAAmB,aAAU,CAAC"}

package/lib/typescript/src/media.d.ts

@@ -0,0 +1,81 @@
+import type { LaconiusConfig } from './config.js';
+import type { Image, ImageGroup, Images } from './models.js';
+/**
+ * Format code to width in pixels, ported from Spartacus'
+ * `core-libs/storefront/recipes/config/default-media.config.ts`.
+ *
+ * The codes are widths, not device classes. Mapping a phone to `mobile` (400px) would upscale a
+ * hero 3x on a @3x screen, so nothing here maps device to format.
+ */
+export declare const defaultMediaFormats: Record<string, number>;
+/** A role caps the candidate set; it does not select a single asset. No role means no cap. */
+export declare const defaultMediaRoles: Record<string, string>;
+/** What `expo-image` accepts as one entry of an `ImageSource[]`. */
+export type MediaSource = {
+    uri: string;
+    width?: number;
+    height?: number;
+};
+export type MediaContainer = ImageGroup | Image | undefined;
+export declare function getMediaBaseUrl(config: LaconiusConfig): string;
+/**
+ * Absolutises an OCC media path. Absolute URLs, protocol-relative URLs and `data:` URIs are
+ * returned untouched — Spartacus absolutises `data:` URIs in one of its two paths and breaks
+ * them there.
+ */
+export declare function resolveMediaUrl(media: Image | undefined, baseUrl: string): string | undefined;
+/** Format codes ascending by width, unknown widths last in declaration order. */
+export declare function sortFormats(formats: Record<string, number>): {
+    code: string;
+    width: number;
+}[];
+/**
+ * Formats up to and including `maxFormat`. An unknown `maxFormat` caps nothing, which is
+ * Spartacus' behaviour and the safe one: a typo shows a big image, not no image.
+ */
+export declare function getFormatsUpToMaxFormat<T extends {
+    code: string;
+}>(formats: T[], maxFormat?: string): T[];
+/**
+ * The candidate set for one media container, widths attached.
+ *
+ * `expo-image` picks the source that best fits the measured container at the screen scale, so
+ * the caller never decides "which format" and never passes the container size.
+ */
+export declare function resolveMediaCandidates(media: MediaContainer, options: {
+    baseUrl: string;
+    role?: string;
+    /** Explicit cap, overriding the one the role implies. */
+    maxFormat?: string;
+    formats?: Record<string, number>;
+    roles?: Record<string, string>;
+}): MediaSource[];
+/**
+ * Absolutises every media URL inside a payload, on the way in.
+ *
+ * One mechanism for CMS media and product images alike ([chapter 08](../../../docs/spec/08-media.md)),
+ * where Spartacus has two unrelated ones. The walk is shape-agnostic because media reaches the
+ * client as an `Image`, as a group keyed by format code, and as arrays of either.
+ */
+export declare function absolutizeMedia<T>(value: T, baseUrl: string): T;
+/**
+ * The `PRIMARY` group of a normalized `Images`, which is what a card, a thumbnail and a gallery's
+ * first slide all want. OCC only ever sends one primary image, so an array here is a payload
+ * oddity rather than a case to support.
+ */
+export declare function getPrimaryImage(images: Images | undefined): ImageGroup | undefined;
+/** The `GALLERY` groups in `galleryIndex` order, with the primary image first when there is one. */
+export declare function getGalleryImages(images: Images | undefined): ImageGroup[];
+/**
+ * Reshapes OCC's flat `Image[]` into `images.PRIMARY.zoom` / `images.GALLERY[i].thumbnail`,
+ * ported from `core-libs/core/src/occ/adapters/product/converters/product-image-normalizer.ts:36-100`.
+ *
+ * Lives in core because product payloads and cart entry products carry the same flat list —
+ * one mechanism ([chapter 08](../../../docs/spec/08-media.md)), and no `cart -> product` edge
+ * exists to borrow it over ([chapter 01](../../../docs/spec/01-packages.md)).
+ *
+ * URLs are **not** absolutised here: a converter is a pure function with no access to config, so
+ * adapters absolutise the whole payload afterwards through `absolutizeMedia`.
+ */
+export declare function normalizeImages(source: Image[] | undefined): Images;
+//# sourceMappingURL=media.d.ts.map

package/lib/typescript/src/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../src/media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAU,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAStD,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAIpD,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,WAAW,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,CAAC;AAE5D,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,GAAG,SAAS,EACxB,OAAO,EAAE,MAAM,GACd,MAAM,GAAG,SAAS,CAKpB;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,CAInC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAChE,OAAO,EAAE,CAAC,EAAE,EACZ,SAAS,CAAC,EAAE,MAAM,GACjB,CAAC,EAAE,CAGL;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE;IACP,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,GACA,WAAW,EAAE,CAuBf;AAiBD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,CAAC,CAY/D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAGlF;AAED,oGAAoG;AACpG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,EAAE,CAMzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,SAAS,GAAG,MAAM,CASnE"}