@salesforce/b2c-tooling-sdk 1.17.0 → 1.19.0

package/dist/esm/docs/types.d.ts

@@ -1,17 +1,67 @@
 export declare const SCRIPT_API_DATA_DIR: string;
 export declare const XSD_DATA_DIR: string;
 export declare const JOB_STEPS_DATA_DIR: string;
+export declare const GUIDES_DATA_DIR: string;
+export declare const TOOLING_DATA_DIR: string;
+/**
+ * The corpus a documentation entry belongs to. Used to tag and filter results
+ * so agents can narrow a search to a documentation set (e.g., only Storefront
+ * Next guides, or only the Script API reference).
+ *
+ * - `script-api` — B2C Commerce Script API class/module reference
+ * - `job-step` — standard (system) job step reference
+ * - `commerce-api` / `pwa-kit-managed-runtime` / `sfnext` / `sfra` / `b2c-commerce`
+ *   — Developer Center prose guides, one category per Developer Center project
+ * - `tooling` — this project's own conceptual guides (CLI/MCP/SDK usage)
+ */
+export type DocCategory = 'script-api' | 'job-step' | 'commerce-api' | 'pwa-kit-managed-runtime' | 'sfnext' | 'sfra' | 'b2c-commerce' | 'tooling';
 /**
  * A documentation entry in the search index.
+ *
+ * Entries span multiple corpora (Script API reference, job steps, Developer
+ * Center guides, and this project's own docs). Reference entries are bundled
+ * on disk and read via {@link DocEntry.filePath}; guide entries are indexed
+ * locally but their full content is fetched on demand from {@link DocEntry.url}.
  */
 export interface DocEntry {
-    /** Unique identifier - the filename without .md extension (e.g., "dw.catalog.ProductMgr") */
+    /**
+     * Unique identifier. For bundled reference this is the filename without its
+     * extension (e.g., "dw.catalog.ProductMgr"); for guides it is namespaced by
+     * category to avoid cross-corpus collisions (e.g., "sfnext/sfnext-get-started").
+     */
     id: string;
-    /** The title from the document heading (e.g., "Class ProductMgr") */
+    /** The title from the document's first heading (e.g., "Class ProductMgr"). */
     title: string;
-    /** The filename (e.g., "dw.catalog.ProductMgr.md") */
-    filePath: string;
-    /** Optional preview/excerpt from the document */
+    /** The corpus/category this entry belongs to. */
+    category?: DocCategory;
+    /**
+     * Path of the bundled markdown file relative to its corpus data directory.
+     * Present for entries whose content ships in the package; absent for entries
+     * whose content is fetched online (see {@link DocEntry.sourceUrl}).
+     */
+    filePath?: string;
+    /**
+     * Canonical human-facing published URL (the rendered `.html` page, e.g. on
+     * developer.salesforce.com). This is the durable link to cite/open in a
+     * browser. Present for every corpus that has a public page (guides, Script
+     * API reference, tooling); absent for corpora with no public page (job steps).
+     */
+    url?: string;
+    /**
+     * The raw-markdown (`.md`) URL for the same document — the machine-readable
+     * source. For online-only entries (guides) this is what {@link readEntryContent}
+     * fetches at read time. Bundled corpora (Script API, tooling) also carry it so
+     * callers can retrieve the raw source on request even though content ships in
+     * the package. Absent for corpora with no public page (job steps).
+     */
+    sourceUrl?: string;
+    /** Section headings joined into a single searchable string (indexed, not for display). */
+    headings?: string;
+    /** One-line summary describing what task/topic the doc helps with (agent triage). */
+    summary?: string;
+    /** Search keywords/synonyms an agent or developer might use to find this doc. */
+    keywords?: string[];
+    /** Optional preview/excerpt from the document. */
     preview?: string;
 }
 /**
@@ -31,7 +81,7 @@ export interface SearchIndex {
 export interface SearchResult {
     /** The matching documentation entry */
     entry: DocEntry;
-    /** Match score (lower is better in Fuse.js, 0 = perfect match) */
+    /** Relevance score (higher is better; scale is engine-relative, not normalized). */
     score: number;
 }
 /**

package/dist/esm/docs/types.js

@@ -13,4 +13,6 @@ const packageRoot = path.dirname(require.resolve('@salesforce/b2c-tooling-sdk/pa
 export const SCRIPT_API_DATA_DIR = path.join(packageRoot, 'data/script-api');
 export const XSD_DATA_DIR = path.join(packageRoot, 'data/xsd');
 export const JOB_STEPS_DATA_DIR = path.join(packageRoot, 'data/job-steps');
+export const GUIDES_DATA_DIR = path.join(packageRoot, 'data/guides');
+export const TOOLING_DATA_DIR = path.join(packageRoot, 'data/tooling');
 //# sourceMappingURL=types.js.map

package/dist/esm/docs/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/docs/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAE1C,qDAAqD;AACrD,wEAAwE;AACxE,iEAAiE;AACjE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC,CAAC;AAE9F,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/docs/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAC,aAAa,EAAC,MAAM,aAAa,CAAC;AAE1C,qDAAqD;AACrD,wEAAwE;AACxE,iEAAiE;AACjE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC,CAAC;AAE9F,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;AAC3E,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC"}

package/dist/esm/index.d.ts

@@ -8,8 +8,8 @@ export { BasicAuthStrategy, OAuthStrategy, ImplicitOAuthStrategy, JwtOAuthStrate
 export type { AuthStrategy, AccessTokenResponse, DecodedJWT, OAuthConfig, ImplicitOAuthConfig, JwtOAuthConfig, AuthConfig, BasicAuthConfig, OAuthAuthConfig, ApiKeyAuthConfig, AuthMethod, AuthCredentials, ResolveAuthStrategyOptions, AvailableAuthMethods, } from './auth/index.js';
 export { B2CInstance } from './instance/index.js';
 export type { InstanceConfig } from './instance/index.js';
-export { WebDavClient, createOcapiClient, createAuthMiddleware, createExtraParamsMiddleware, createSlasClient, createOdsClient, createCustomApisClient, createAccountManagerUsersClient, createAccountManagerRolesClient, createAccountManagerApiClientsClient, createAccountManagerOrgsClient, createCdnZonesClient, createGranularReplicationsClient, createCipClient, toOrganizationId, normalizeTenantId, buildTenantScope, getApiErrorMessage, isValidRoleTenantFilter, fetchRoleMapping, resolveToInternalRole, resolveFromInternalRole, ORGANIZATION_ID_PREFIX, ROLE_TENANT_FILTER_PATTERN, SCAPI_TENANT_SCOPE_PREFIX, CUSTOM_APIS_DEFAULT_SCOPES, CDN_ZONES_READ_SCOPES, CDN_ZONES_RW_SCOPES, DEFAULT_CIP_HOST, DEFAULT_CIP_STAGING_HOST, } from './clients/index.js';
-export type { PropfindEntry, ExtraParamsConfig, OcapiClient, OcapiError, OcapiResponse, OcapiPaths, OcapiComponents, SlasClient, SlasClientConfig, SlasError, SlasResponse, SlasPaths, SlasComponents, OdsClient, OdsClientConfig, OdsError, OdsResponse, OdsPaths, OdsComponents, CustomApisClient, CustomApisClientConfig, CustomApisError, CustomApisResponse, CustomApisPaths, CustomApisComponents, AccountManagerUsersClient, AccountManagerClientConfig, AccountManagerUser, AccountManagerResponse, AccountManagerError, UserCreate, UserUpdate, UserCollection, UserState, UserExpandOption, AccountManagerRolesClient, AccountManagerRole, AccountManagerRolesResponse, AccountManagerRolesError, RoleCollection, ListRolesOptions, RoleMapping, OrgMapping, AccountManagerApiClientsClient, AccountManagerApiClient, APIClientCreate, APIClientUpdate, APIClientCollection, ApiClientExpandOption, ListApiClientsOptions, AccountManagerOrgsClient, AccountManagerOrganization, OrganizationCollection, ListOrgsOptions, CdnZonesClient, CdnZonesClientConfig, CdnZonesClientOptions, CdnZonesError, CdnZonesResponse, Zone, ZonesEnvelope, CdnZonesPaths, CdnZonesComponents, GranularReplicationsClient, GranularReplicationsClientConfig, GranularReplicationsError, GranularReplicationsResponse, ProductItem, PriceTableItem, ContentAssetItemPrivate, ContentAssetItemShared, PublishProcessResponse, PublishProcessListResponse, PublishIdResponse, GranularReplicationsPaths, GranularReplicationsComponents, CipClient, CipClientConfig, CipColumn, CipExecuteResponse, CipFetchResponse, CipFrame, CipQueryOptions, CipQueryResult, } from './clients/index.js';
+export { WebDavClient, createOcapiClient, createAuthMiddleware, createExtraParamsMiddleware, createSlasClient, createOdsClient, createCustomApisClient, createAccountManagerUsersClient, createAccountManagerRolesClient, createAccountManagerApiClientsClient, createAccountManagerOrgsClient, createCdnZonesClient, createGranularReplicationsClient, createCipClient, createMetricsClient, METRICS_DEFAULT_SCOPES, toOrganizationId, normalizeTenantId, buildTenantScope, getApiErrorMessage, isValidRoleTenantFilter, fetchRoleMapping, resolveToInternalRole, resolveFromInternalRole, ORGANIZATION_ID_PREFIX, ROLE_TENANT_FILTER_PATTERN, SCAPI_TENANT_SCOPE_PREFIX, CUSTOM_APIS_DEFAULT_SCOPES, CDN_ZONES_READ_SCOPES, CDN_ZONES_RW_SCOPES, DEFAULT_CIP_HOST, DEFAULT_CIP_STAGING_HOST, } from './clients/index.js';
+export type { PropfindEntry, ExtraParamsConfig, OcapiClient, OcapiError, OcapiResponse, OcapiPaths, OcapiComponents, SlasClient, SlasClientConfig, SlasError, SlasResponse, SlasPaths, SlasComponents, OdsClient, OdsClientConfig, OdsError, OdsResponse, OdsPaths, OdsComponents, CustomApisClient, CustomApisClientConfig, CustomApisError, CustomApisResponse, CustomApisPaths, CustomApisComponents, AccountManagerUsersClient, AccountManagerClientConfig, AccountManagerUser, AccountManagerResponse, AccountManagerError, UserCreate, UserUpdate, UserCollection, UserState, UserExpandOption, AccountManagerRolesClient, AccountManagerRole, AccountManagerRolesResponse, AccountManagerRolesError, RoleCollection, ListRolesOptions, RoleMapping, OrgMapping, AccountManagerApiClientsClient, AccountManagerApiClient, APIClientCreate, APIClientUpdate, APIClientCollection, ApiClientExpandOption, ListApiClientsOptions, AccountManagerOrgsClient, AccountManagerOrganization, OrganizationCollection, ListOrgsOptions, CdnZonesClient, CdnZonesClientConfig, CdnZonesClientOptions, CdnZonesError, CdnZonesResponse, Zone, ZonesEnvelope, CdnZonesPaths, CdnZonesComponents, GranularReplicationsClient, GranularReplicationsClientConfig, GranularReplicationsError, GranularReplicationsResponse, ProductItem, PriceTableItem, ContentAssetItemPrivate, ContentAssetItemShared, PublishProcessResponse, PublishProcessListResponse, PublishIdResponse, GranularReplicationsPaths, GranularReplicationsComponents, CipClient, CipClientConfig, CipColumn, CipExecuteResponse, CipFetchResponse, CipFrame, CipQueryOptions, CipQueryResult, MetricsClient, MetricsClientConfig, MetricsResponse, MetricsDataResponse, Metric, MetricDataSeries, MetricDataPoint, MetricsError, } from './clients/index.js';
 export { findCartridges, listCodeVersions, getActiveCodeVersion, activateCodeVersion, reloadCodeVersion, deleteCodeVersion, createCodeVersion, findAndDeployCartridges, uploadCartridges, deleteCartridges, watchCartridges, } from './operations/code/index.js';
 export type { CartridgeMapping, FindCartridgesOptions, CodeVersion, CodeVersionResult, DeployOptions, DeployResult, WatchOptions, WatchResult, } from './operations/code/index.js';
 export { executeJob, getJobExecution, waitForJob, searchJobExecutions, findRunningJobExecution, getJobLog, getJobErrorMessage, JobExecutionError, siteArchiveImport, siteArchiveExport, siteArchiveExportToPath, } from './operations/jobs/index.js';
@@ -21,6 +21,8 @@ export type { SandboxState, WaitForSandboxOptions, WaitForSandboxPollInfo } from
 export type { CloneState, WaitForCloneOptions, WaitForClonePollInfo } from './operations/ods/index.js';
 export { booleanLiteral, buildCipReportSql, dateLiteral, describeCipTable, escapeSqlString, executeCipReport, getCipReportByName, integerLiteral, isReservedIdentifier, listCipReports, listCipTables, quoteIdentifierIfReserved, stringInList, stringLiteral, } from './operations/cip/index.js';
 export type { CipColumnMetadata, CipDescribeTableOptions, CipDescribeTableResult, CipListTablesOptions, CipListTablesResult, CipReportDefinition, CipReportExecutionOptions, CipReportParamType, CipReportParamDefinition, CipReportQueryExecutor, CipReportQueryResult, CipReportSqlResult, CipTableMetadata, } from './operations/cip/index.js';
+export { getOverallMetrics, getSalesMetrics, getEcdnMetrics, getThirdPartyMetrics, getScapiMetrics, getScapiHooksMetrics, getMrtMetrics, getControllerMetrics, getOcapiMetrics, getMetricsByCategory, parseMetricsBound, resolveMetricsWindow, parseSeriesTags, enrichMetricsTags, METRIC_CATEGORIES, METRICS_RETENTION_MS, METRICS_RETENTION_SAFETY_MARGIN_MS, METRICS_DEFAULT_WINDOW_MS, } from './operations/metrics/index.js';
+export type { MetricCategory, MetricsTimeWindow, MetricsBoundInput, MetricsWindowInput, ResolvedMetricsWindow, MetricSeriesTags, MetricsTagContext, MetricsTaggedResponse, ThirdPartyMetricsOptions, ScapiMetricsOptions, OcapiMetricsOptions, MetricsQueryOptions, } from './operations/metrics/index.js';
 export { getUser, getUserByLogin, listUsers, createUser, updateUser, deleteUser, purgeUser, resetUser, grantRole, revokeRole, } from './operations/users/index.js';
 export { validateCap, commerceAppInstall, commerceAppUninstall, commerceAppPackage, discoverLocalApps, listInstalledApps, parseCommerceFeatureStatesXml, readManifest, pullCommerceApps, } from './operations/cap/index.js';
 export type { CapValidationResult, CommerceAppManifest, CommerceAppInstallOptions, CommerceAppInstallResult, CommerceAppUninstallOptions, CommerceAppUninstallResult, CommerceAppPackageOptions, CommerceAppPackageResult, CommerceFeatureState, LocalCommerceApp, ListInstalledAppsOptions, ListInstalledAppsResult, PullCommerceAppsOptions, PullCommerceAppsResult, PulledApp, PullSource, } from './operations/cap/index.js';

package/dist/esm/index.js

@@ -13,7 +13,7 @@ export { BasicAuthStrategy, OAuthStrategy, ImplicitOAuthStrategy, JwtOAuthStrate
 // Context Layer - Instance
 export { B2CInstance } from './instance/index.js';
 // Clients
-export { WebDavClient, createOcapiClient, createAuthMiddleware, createExtraParamsMiddleware, createSlasClient, createOdsClient, createCustomApisClient, createAccountManagerUsersClient, createAccountManagerRolesClient, createAccountManagerApiClientsClient, createAccountManagerOrgsClient, createCdnZonesClient, createGranularReplicationsClient, createCipClient, toOrganizationId, normalizeTenantId, buildTenantScope, getApiErrorMessage, isValidRoleTenantFilter, fetchRoleMapping, resolveToInternalRole, resolveFromInternalRole, ORGANIZATION_ID_PREFIX, ROLE_TENANT_FILTER_PATTERN, SCAPI_TENANT_SCOPE_PREFIX, CUSTOM_APIS_DEFAULT_SCOPES, CDN_ZONES_READ_SCOPES, CDN_ZONES_RW_SCOPES, DEFAULT_CIP_HOST, DEFAULT_CIP_STAGING_HOST, } from './clients/index.js';
+export { WebDavClient, createOcapiClient, createAuthMiddleware, createExtraParamsMiddleware, createSlasClient, createOdsClient, createCustomApisClient, createAccountManagerUsersClient, createAccountManagerRolesClient, createAccountManagerApiClientsClient, createAccountManagerOrgsClient, createCdnZonesClient, createGranularReplicationsClient, createCipClient, createMetricsClient, METRICS_DEFAULT_SCOPES, toOrganizationId, normalizeTenantId, buildTenantScope, getApiErrorMessage, isValidRoleTenantFilter, fetchRoleMapping, resolveToInternalRole, resolveFromInternalRole, ORGANIZATION_ID_PREFIX, ROLE_TENANT_FILTER_PATTERN, SCAPI_TENANT_SCOPE_PREFIX, CUSTOM_APIS_DEFAULT_SCOPES, CDN_ZONES_READ_SCOPES, CDN_ZONES_RW_SCOPES, DEFAULT_CIP_HOST, DEFAULT_CIP_STAGING_HOST, } from './clients/index.js';
 // Operations - Code
 export { findCartridges, listCodeVersions, getActiveCodeVersion, activateCodeVersion, reloadCodeVersion, deleteCodeVersion, createCodeVersion, findAndDeployCartridges, uploadCartridges, deleteCartridges, watchCartridges, } from './operations/code/index.js';
 // Operations - Jobs
@@ -24,6 +24,8 @@ export { searchDocs, readDoc, readDocByQuery, listDocs, loadSearchIndex, listSch
 export { isUuid, isFriendlySandboxId, parseFriendlySandboxId, resolveSandboxId, SandboxNotFoundError, waitForSandbox, SandboxPollingTimeoutError, SandboxPollingError, SandboxTerminalStateError, waitForClone, ClonePollingTimeoutError, ClonePollingError, CloneFailedError, } from './operations/ods/index.js';
 // Operations - CIP
 export { booleanLiteral, buildCipReportSql, dateLiteral, describeCipTable, escapeSqlString, executeCipReport, getCipReportByName, integerLiteral, isReservedIdentifier, listCipReports, listCipTables, quoteIdentifierIfReserved, stringInList, stringLiteral, } from './operations/cip/index.js';
+// Operations - Metrics (Observability)
+export { getOverallMetrics, getSalesMetrics, getEcdnMetrics, getThirdPartyMetrics, getScapiMetrics, getScapiHooksMetrics, getMrtMetrics, getControllerMetrics, getOcapiMetrics, getMetricsByCategory, parseMetricsBound, resolveMetricsWindow, parseSeriesTags, enrichMetricsTags, METRIC_CATEGORIES, METRICS_RETENTION_MS, METRICS_RETENTION_SAFETY_MARGIN_MS, METRICS_DEFAULT_WINDOW_MS, } from './operations/metrics/index.js';
 // Operations - Users
 export { getUser, getUserByLogin, listUsers, createUser, updateUser, deleteUser, purgeUser, resetUser, grantRole, revokeRole, } from './operations/users/index.js';
 // Operations - CAP (Commerce App Packages)

package/dist/esm/index.js.map

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

package/dist/esm/operations/logs/filter.d.ts

@@ -9,8 +9,13 @@ export declare function parseRelativeTime(timeStr: string): null | number;
  * Supports:
  * - Relative times: "5m", "1h", "2d"
  * - ISO 8601: "2026-01-25T10:00:00"
+ *
+ * @param sinceStr - The value to parse
+ * @param now - Reference time for relative values (defaults to the current time).
+ *   Injectable so callers that resolve several bounds together, or that need
+ *   deterministic behavior in tests, can pin a single "now".
  */
-export declare function parseSinceTime(sinceStr: string): Date;
+export declare function parseSinceTime(sinceStr: string, now?: Date): Date;
 /**
  * Parses a B2C log timestamp into a Date object.
  * Expected format: "2025-01-25 10:30:45.123 GMT"

package/dist/esm/operations/logs/filter.js

@@ -34,11 +34,16 @@ export function parseRelativeTime(timeStr) {
  * Supports:
  * - Relative times: "5m", "1h", "2d"
  * - ISO 8601: "2026-01-25T10:00:00"
+ *
+ * @param sinceStr - The value to parse
+ * @param now - Reference time for relative values (defaults to the current time).
+ *   Injectable so callers that resolve several bounds together, or that need
+ *   deterministic behavior in tests, can pin a single "now".
  */
-export function parseSinceTime(sinceStr) {
+export function parseSinceTime(sinceStr, now = new Date()) {
     const relativeMs = parseRelativeTime(sinceStr);
     if (relativeMs !== null) {
-        return new Date(Date.now() - relativeMs);
+        return new Date(now.getTime() - relativeMs);
     }
     const date = new Date(sinceStr);
     if (Number.isNaN(date.getTime())) {

package/dist/esm/operations/logs/filter.js.map

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

package/dist/esm/operations/metrics/index.d.ts

@@ -0,0 +1,371 @@
+/**
+ * Metrics operations for B2C Commerce (Observability).
+ *
+ * This module provides typed, high-level functions for retrieving operational
+ * time-series metrics from the SCAPI Observability Metrics API
+ * (`observability/metrics/v1`). Each metric *category* has its own function; all
+ * return the same {@link MetricsDataResponse} envelope.
+ *
+ * ## Categories
+ *
+ * - {@link getOverallMetrics} — overall application metrics
+ * - {@link getSalesMetrics} — sales metrics
+ * - {@link getEcdnMetrics} — embedded CDN metrics
+ * - {@link getThirdPartyMetrics} — third-party service call metrics (filterable by service)
+ * - {@link getScapiMetrics} — SCAPI request metrics (filterable by API family/name)
+ * - {@link getScapiHooksMetrics} — SCAPI hook execution metrics
+ * - {@link getMrtMetrics} — Managed Runtime metrics
+ * - {@link getControllerMetrics} — controller/pipeline metrics
+ * - {@link getOcapiMetrics} — OCAPI request metrics (filterable by category/api)
+ *
+ * {@link getMetricsByCategory} dispatches to the correct function by category
+ * name — convenient for CLIs and tools that take a category as input.
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import {createMetricsClient} from '@salesforce/b2c-tooling-sdk/clients';
+ * import {getOverallMetrics} from '@salesforce/b2c-tooling-sdk/operations/metrics';
+ *
+ * const client = createMetricsClient({shortCode, tenantId}, auth);
+ * const result = await getOverallMetrics(client, tenantId, {from, to});
+ * for (const metric of result.data) {
+ *   console.log(metric.title, metric.dataSeries.length);
+ * }
+ * ```
+ *
+ * ## Authentication
+ *
+ * Requires OAuth client-credentials with the `sfcc.metrics` admin scope. The
+ * {@link createMetricsClient} factory attaches this scope plus the tenant scope
+ * automatically.
+ *
+ * @module operations/metrics
+ */
+import type { MetricsClient, MetricsDataResponse } from '../../clients/metrics.js';
+export type { MetricsClient, MetricsClientConfig, MetricsDataResponse, Metric, MetricDataSeries, MetricDataPoint, MetricsError, } from '../../clients/metrics.js';
+/**
+ * All metric categories exposed by the Metrics API, in a stable, documented order.
+ *
+ * Values match the API path segments (e.g. `overall` → `/metrics/overall`).
+ */
+export declare const METRIC_CATEGORIES: readonly ["overall", "sales", "ecdn", "third-party", "scapi", "scapi-hooks", "mrt", "controller", "ocapi"];
+/**
+ * A metric category name. One of {@link METRIC_CATEGORIES}.
+ */
+export type MetricCategory = (typeof METRIC_CATEGORIES)[number];
+/**
+ * Time-window options common to every metrics operation.
+ *
+ * Accepts either a {@link Date} or a number of **epoch milliseconds** (the same
+ * unit as `Date.now()`), for both `from` and `to`. Both are optional; when
+ * omitted the API applies its default window. When both are supplied, `from`
+ * must be before `to` or the API returns a 400.
+ *
+ * > **Note:** The Metrics API wire format is epoch **seconds**, and the data
+ * > points it returns are timestamped in **seconds**. These operations convert
+ * > millisecond inputs to seconds on the way out and normalize response
+ * > timestamps back to **milliseconds** on the way in, so callers work in
+ * > JS-native millisecond time throughout (e.g. `new Date(point.timestamp)`).
+ */
+export interface MetricsTimeWindow {
+    /** Start of the window — a {@link Date} or epoch milliseconds (inclusive). */
+    from?: Date | number;
+    /** End of the window — a {@link Date} or epoch milliseconds (inclusive). */
+    to?: Date | number;
+}
+/**
+ * Options for {@link getThirdPartyMetrics}: time window plus an optional
+ * third-party service filter.
+ */
+export interface ThirdPartyMetricsOptions extends MetricsTimeWindow {
+    /** Restrict results to a single third-party service by its id. */
+    thirdPartyServiceId?: string;
+}
+/**
+ * Options for {@link getScapiMetrics}: time window plus optional SCAPI filters.
+ */
+export interface ScapiMetricsOptions extends MetricsTimeWindow {
+    /** Restrict results to a SCAPI API family (e.g. `product`, `checkout`). */
+    apiFamily?: string;
+    /** Restrict results to a SCAPI API name (e.g. `shopper-products`). */
+    apiName?: string;
+}
+/**
+ * Options for {@link getOcapiMetrics}: time window plus optional OCAPI filters.
+ */
+export interface OcapiMetricsOptions extends MetricsTimeWindow {
+    /** Restrict results to an OCAPI category (e.g. `shop`, `data`). */
+    ocapiCategory?: string;
+    /** Restrict results to a specific OCAPI API. */
+    ocapiApi?: string;
+}
+/**
+ * Union of every option shape accepted by {@link getMetricsByCategory}.
+ */
+export type MetricsQueryOptions = MetricsTimeWindow & Partial<Pick<ThirdPartyMetricsOptions, 'thirdPartyServiceId'>> & Partial<Pick<ScapiMetricsOptions, 'apiFamily' | 'apiName'>> & Partial<Pick<OcapiMetricsOptions, 'ocapiCategory' | 'ocapiApi'>>;
+/**
+ * How far back the Metrics API retains data: `from` must be no older than
+ * `serverNow - 30 days`, or the API returns 400.
+ */
+export declare const METRICS_RETENTION_MS: number;
+/**
+ * Default (and maximum) width of a metrics time window: 24 hours.
+ *
+ * The Metrics API pairs a request that omits `to` with its own `now` and then
+ * enforces a maximum window of `to - from ≤ 24h`, rejecting anything wider with a
+ * 400. An open-ended `from` older than 24h therefore always fails. To make the
+ * behavior predictable, {@link resolveMetricsWindow} fills in a 24-hour window
+ * (clamped so `to` never exceeds `now`) for any bound the caller leaves open, and
+ * always sends both `from` and `to`. This is only a *default* for derivation — an
+ * explicit `from`+`to` range wider than 24h is still sent as-is, letting the API
+ * remain authoritative and return its own error.
+ */
+export declare const METRICS_DEFAULT_WINDOW_MS: number;
+/**
+ * Safety margin kept *inside* the retention window when clamping `from`. Because
+ * the server evaluates retention against its own clock at request time, a `from`
+ * computed as exactly "30 days ago" on the client is reliably rejected once
+ * request latency and client/server clock skew are added. {@link resolveMetricsWindow}
+ * therefore clamps a `from` that lands within this margin of the retention floor
+ * up to `now - 30 days + margin`, so edge requests (e.g. `--from 30d`) succeed.
+ * 5 minutes comfortably covers latency and typical skew while costing a
+ * negligible fraction of the 30-day window.
+ */
+export declare const METRICS_RETENTION_SAFETY_MARGIN_MS: number;
+/**
+ * A metrics bound as accepted from a CLI flag or MCP argument: a {@link Date},
+ * epoch **milliseconds**, or a human string — a relative duration (`5m`, `1h`,
+ * `2d`, interpreted as "ago") or an ISO 8601 timestamp.
+ */
+export type MetricsBoundInput = Date | number | string;
+/**
+ * Parses a single metrics time bound (`from` or `to`) into a {@link Date}.
+ *
+ * This is the shared bound parser for the CLI `metrics get` command and the MCP
+ * `metrics_get` tool. It resolves a single bound in isolation; deriving the
+ * companion bound and applying the 24-hour default window is the job of
+ * {@link resolveMetricsWindow}.
+ *
+ * @param value - The bound: a Date, epoch milliseconds, a relative duration
+ *   (`5m`/`1h`/`2d`, relative to `now`), or an ISO 8601 timestamp
+ * @param now - Reference time for relative durations (defaults to the current
+ *   time; injectable for deterministic tests)
+ * @returns The resolved {@link Date}
+ * @throws TypeError if a string value is neither a valid relative duration nor
+ *   a parseable ISO 8601 timestamp
+ *
+ * @example
+ * ```typescript
+ * const from = parseMetricsBound('2d');            // 2 days ago
+ * const to = parseMetricsBound('2026-01-25T12:00:00Z');
+ * await getSalesMetrics(client, tenantId, {from, to});
+ * ```
+ */
+export declare function parseMetricsBound(value: MetricsBoundInput, now?: Date): Date;
+/**
+ * Raw `from`/`to`/`window` inputs, as accepted from CLI flags or MCP arguments,
+ * before resolution. Any subset may be provided.
+ */
+export interface MetricsWindowInput {
+    /** Start bound (Date, epoch ms, relative like `7d`, or ISO 8601). */
+    from?: MetricsBoundInput;
+    /** End bound (Date, epoch ms, relative like `6h`, or ISO 8601). */
+    to?: MetricsBoundInput;
+    /**
+     * Window duration as a relative string (`1h`, `30m`, `2d`) or a number of
+     * **milliseconds**. Combined with exactly one of `from`/`to` it derives the
+     * other bound; supplied alone it means "the last {window}".
+     */
+    window?: number | string;
+}
+/**
+ * A resolved metrics window. Both `from` and `to` are always present: the
+ * resolver derives whichever bound the caller left open using the 24-hour
+ * default window (see {@link METRICS_DEFAULT_WINDOW_MS}) and always sends an
+ * explicit range, so the request never depends on the server's implicit `to`.
+ * Epoch-second echoes are included for reporting.
+ */
+export interface ResolvedMetricsWindow {
+    /** Resolved start bound. */
+    from: Date;
+    /** Resolved end bound. */
+    to: Date;
+    /** ISO 8601 form of {@link from}. */
+    fromIso: string;
+    /** ISO 8601 form of {@link to}. */
+    toIso: string;
+    /** Epoch **seconds** form of {@link from} (the API wire unit). */
+    fromEpochSeconds: number;
+    /** Epoch **seconds** form of {@link to} (the API wire unit). */
+    toEpochSeconds: number;
+    /**
+     * True when `from` was clamped forward to stay inside the retention window
+     * (see {@link METRICS_RETENTION_SAFETY_MARGIN_MS}). Surfaced so callers can
+     * report that the effective start differs slightly from what was requested.
+     */
+    clampedFrom: boolean;
+    /**
+     * True when a bound was derived from the 24-hour default window rather than
+     * supplied by the caller (e.g. `from` alone, `to` alone, or nothing at all).
+     * Surfaced so callers can note that the effective range was defaulted.
+     */
+    defaultedWindow: boolean;
+}
+/**
+ * Resolves `from`/`to`/`window` inputs into the concrete bounds to send to the
+ * Metrics API. This is the shared resolver for the CLI `metrics get` command and
+ * the MCP `metrics_get` tool, so both share identical, tested semantics.
+ *
+ * The resolver always produces an explicit `from`+`to` pair. The Metrics API
+ * pairs a request that omits `to` with its own `now` and enforces a 24-hour
+ * maximum window, so an open-ended `from` older than 24 hours always fails; to
+ * make the behavior predictable, any bound the caller leaves open is filled from
+ * the 24-hour default window (see {@link METRICS_DEFAULT_WINDOW_MS}) rather than
+ * relying on the server's implicit end.
+ *
+ * The `window` duration makes fixed-width lookbacks easy without hand-computing
+ * a second timestamp — e.g. "a 1-hour window starting 7 days ago" is
+ * `{from: '7d', window: '1h'}`. Resolution rules:
+ *
+ * - `from` + `to` — used as given; `window` must NOT also be set. An explicit
+ *   range wider than the 24-hour maximum is still sent as-is, leaving the API to
+ *   return its own error.
+ * - `from` + `window` — `to = from + window`.
+ * - `to` + `window` — `from = to - window`.
+ * - `window` only — the last `window`: `to = now`, `from = now - window`.
+ * - `from` only — a 24-hour window forward from `from`: `to = min(from + 24h, now)`.
+ * - `to` only — a 24-hour window back from `to`: `from = to - 24h`.
+ * - nothing — the last 24 hours: `to = now`, `from = now - 24h`.
+ *
+ * Bounds filled from the 24-hour default (the last three rules) set
+ * {@link ResolvedMetricsWindow.defaultedWindow}. Validation is structural
+ * (over-specification and `from` after `to`). Additionally, a `from` that lands
+ * at or beyond the 30-day retention floor is clamped *forward* to
+ * `now - 30 days + margin` (see {@link METRICS_RETENTION_SAFETY_MARGIN_MS}) so
+ * requests like `--from 30d` are not rejected by the server's own slightly-later
+ * clock; the clamp is applied before deriving the companion bound so the window
+ * width is preserved, only ever moves `from` toward `now`, and is reported via
+ * {@link ResolvedMetricsWindow.clampedFrom}.
+ *
+ * @param input - The raw `from`/`to`/`window` inputs
+ * @param now - Reference time for relative bounds, default/window modes, and the
+ *   retention clamp (defaults to the current time; injectable for deterministic tests)
+ * @returns The resolved bounds plus ISO/epoch-second echoes and clamp/default flags
+ * @throws TypeError if a bound or the window string is unparseable
+ * @throws RangeError if all three are supplied, or the resolved `from` is after `to`
+ *
+ * @example
+ * ```typescript
+ * // A 1-hour window starting 7 days ago:
+ * const w = resolveMetricsWindow({from: '7d', window: '1h'});
+ * await getScapiMetrics(client, tenantId, {from: w.from, to: w.to});
+ * ```
+ */
+export declare function resolveMetricsWindow(input?: MetricsWindowInput, now?: Date): ResolvedMetricsWindow;
+/**
+ * Retrieves overall application metrics for an organization.
+ *
+ * @param client - Metrics API client from {@link createMetricsClient}
+ * @param tenantId - Tenant ID (with or without the `f_ecom_` prefix)
+ * @param options - Optional time window (epoch milliseconds)
+ * @returns The metrics data response
+ * @throws Error if the request fails
+ */
+export declare function getOverallMetrics(client: MetricsClient, tenantId: string, options?: MetricsTimeWindow): Promise<MetricsDataResponse>;
+/**
+ * Retrieves sales metrics for an organization.
+ *
+ * @param client - Metrics API client from {@link createMetricsClient}
+ * @param tenantId - Tenant ID (with or without the `f_ecom_` prefix)
+ * @param options - Optional time window (epoch milliseconds)
+ * @returns The metrics data response
+ * @throws Error if the request fails
+ */
+export declare function getSalesMetrics(client: MetricsClient, tenantId: string, options?: MetricsTimeWindow): Promise<MetricsDataResponse>;
+/**
+ * Retrieves embedded CDN (eCDN) metrics for an organization.
+ *
+ * @param client - Metrics API client from {@link createMetricsClient}
+ * @param tenantId - Tenant ID (with or without the `f_ecom_` prefix)
+ * @param options - Optional time window (epoch milliseconds)
+ * @returns The metrics data response
+ * @throws Error if the request fails
+ */
+export declare function getEcdnMetrics(client: MetricsClient, tenantId: string, options?: MetricsTimeWindow): Promise<MetricsDataResponse>;
+/**
+ * Retrieves third-party service call metrics for an organization.
+ *
+ * @param client - Metrics API client from {@link createMetricsClient}
+ * @param tenantId - Tenant ID (with or without the `f_ecom_` prefix)
+ * @param options - Optional time window and `thirdPartyServiceId` filter
+ * @returns The metrics data response
+ * @throws Error if the request fails
+ */
+export declare function getThirdPartyMetrics(client: MetricsClient, tenantId: string, options?: ThirdPartyMetricsOptions): Promise<MetricsDataResponse>;
+/**
+ * Retrieves SCAPI request metrics for an organization.
+ *
+ * @param client - Metrics API client from {@link createMetricsClient}
+ * @param tenantId - Tenant ID (with or without the `f_ecom_` prefix)
+ * @param options - Optional time window and `apiFamily`/`apiName` filters
+ * @returns The metrics data response
+ * @throws Error if the request fails
+ */
+export declare function getScapiMetrics(client: MetricsClient, tenantId: string, options?: ScapiMetricsOptions): Promise<MetricsDataResponse>;
+/**
+ * Retrieves SCAPI hook execution metrics for an organization.
+ *
+ * @param client - Metrics API client from {@link createMetricsClient}
+ * @param tenantId - Tenant ID (with or without the `f_ecom_` prefix)
+ * @param options - Optional time window (epoch milliseconds)
+ * @returns The metrics data response
+ * @throws Error if the request fails
+ */
+export declare function getScapiHooksMetrics(client: MetricsClient, tenantId: string, options?: MetricsTimeWindow): Promise<MetricsDataResponse>;
+/**
+ * Retrieves Managed Runtime (MRT) metrics for an organization.
+ *
+ * @param client - Metrics API client from {@link createMetricsClient}
+ * @param tenantId - Tenant ID (with or without the `f_ecom_` prefix)
+ * @param options - Optional time window (epoch milliseconds)
+ * @returns The metrics data response
+ * @throws Error if the request fails
+ */
+export declare function getMrtMetrics(client: MetricsClient, tenantId: string, options?: MetricsTimeWindow): Promise<MetricsDataResponse>;
+/**
+ * Retrieves controller/pipeline metrics for an organization.
+ *
+ * @param client - Metrics API client from {@link createMetricsClient}
+ * @param tenantId - Tenant ID (with or without the `f_ecom_` prefix)
+ * @param options - Optional time window (epoch milliseconds)
+ * @returns The metrics data response
+ * @throws Error if the request fails
+ */
+export declare function getControllerMetrics(client: MetricsClient, tenantId: string, options?: MetricsTimeWindow): Promise<MetricsDataResponse>;
+/**
+ * Retrieves OCAPI request metrics for an organization.
+ *
+ * @param client - Metrics API client from {@link createMetricsClient}
+ * @param tenantId - Tenant ID (with or without the `f_ecom_` prefix)
+ * @param options - Optional time window and `ocapiCategory`/`ocapiApi` filters
+ * @returns The metrics data response
+ * @throws Error if the request fails
+ */
+export declare function getOcapiMetrics(client: MetricsClient, tenantId: string, options?: OcapiMetricsOptions): Promise<MetricsDataResponse>;
+/**
+ * Retrieves metrics for a category by name, dispatching to the category-specific
+ * function. Category-specific filters (`thirdPartyServiceId`, `apiFamily`,
+ * `apiName`, `ocapiCategory`, `ocapiApi`) are applied only for the categories
+ * that support them and ignored otherwise.
+ *
+ * @param client - Metrics API client from {@link createMetricsClient}
+ * @param tenantId - Tenant ID (with or without the `f_ecom_` prefix)
+ * @param category - One of {@link METRIC_CATEGORIES}
+ * @param options - Optional time window and category-specific filters
+ * @returns The metrics data response
+ * @throws Error if the request fails or the category is unknown
+ */
+export declare function getMetricsByCategory(client: MetricsClient, tenantId: string, category: MetricCategory, options?: MetricsQueryOptions): Promise<MetricsDataResponse>;
+export { parseSeriesTags, enrichMetricsTags } from './tags.js';
+export type { MetricSeriesTags, MetricsTagContext, MetricsTaggedResponse } from './tags.js';