@salesforce/b2c-tooling-sdk 1.4.0 → 1.6.0

package/dist/esm/operations/cap/list.js

@@ -0,0 +1,231 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Commerce App listing operations.
+ *
+ * Provides functions for discovering local Commerce App Packages and listing
+ * installed apps on a B2C Commerce instance via site archive export.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import JSZip from 'jszip';
+import * as xml2js from 'xml2js';
+import { B2CInstance } from '../../instance/index.js';
+import { getLogger } from '../../logging/logger.js';
+import { siteArchiveExportToBuffer } from '../jobs/site-archive.js';
+import { readManifest } from './install.js';
+/**
+ * Discovers local Commerce App Packages by searching for commerce-app.json files.
+ *
+ * Walks the directory tree starting from `searchPath`, finds directories
+ * containing a `commerce-app.json` file, and reads each manifest.
+ *
+ * @param searchPath - Root directory to search
+ * @returns Array of discovered local apps with their paths and manifests
+ *
+ * @example
+ * ```typescript
+ * const apps = await discoverLocalApps('./my-workspace');
+ * for (const app of apps) {
+ *   console.log(`${app.manifest.id}@${app.manifest.version} at ${app.path}`);
+ * }
+ * ```
+ */
+export async function discoverLocalApps(searchPath) {
+    const logger = getLogger();
+    const apps = [];
+    const resolvedPath = path.resolve(searchPath);
+    if (!fs.existsSync(resolvedPath)) {
+        return apps;
+    }
+    logger.debug({ searchPath: resolvedPath }, `Discovering local CAPs in: ${resolvedPath}`);
+    findCommerceApps(resolvedPath, apps, logger);
+    logger.debug({ count: apps.length }, `Found ${apps.length} local CAP(s)`);
+    return apps;
+}
+/**
+ * Recursively finds directories containing commerce-app.json.
+ * Stops descending into a directory once a commerce-app.json is found there.
+ */
+function findCommerceApps(dir, apps, logger) {
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    const manifestPath = path.join(dir, 'commerce-app.json');
+    if (fs.existsSync(manifestPath)) {
+        try {
+            const manifest = readManifest(dir);
+            apps.push({ path: dir, manifest });
+        }
+        catch (err) {
+            logger.warn({ path: manifestPath, error: err }, `Skipping invalid commerce-app.json: ${manifestPath}`);
+        }
+        // Don't recurse into CAP directories
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
+            findCommerceApps(path.join(dir, entry.name), apps, logger);
+        }
+    }
+}
+/**
+ * Lists installed Commerce Apps on a B2C instance by exporting commerce feature states.
+ *
+ * Attempts to export the `commerce_feature_states` data unit for each site.
+ * If the export fails (e.g. because the data unit is not yet supported on the server),
+ * falls back to a bundled stub fixture.
+ *
+ * @param instance - B2C instance to query
+ * @param options - Options including optional site filter and wait options
+ * @returns List of commerce feature states across all queried sites
+ *
+ * @example
+ * ```typescript
+ * const result = await listInstalledApps(instance);
+ * for (const state of result.features) {
+ *   console.log(`${state.featureName} (${state.installStatus}) on ${state.siteId}`);
+ * }
+ * ```
+ */
+export async function listInstalledApps(instance, options = {}) {
+    const logger = getLogger();
+    const { waitOptions } = options;
+    // Determine which sites to query
+    let siteIds;
+    if (options.sites && options.sites.length > 0) {
+        siteIds = options.sites;
+    }
+    else {
+        logger.debug('No sites specified, discovering all sites via OCAPI');
+        const { data, error } = await instance.ocapi.GET('/sites', {
+            params: { query: { select: '(**)' } },
+        });
+        if (error || !data) {
+            throw new Error(error?.fault?.message ?? 'Failed to list sites');
+        }
+        siteIds = (data.data ?? []).map((s) => s.id).filter((id) => !!id);
+        logger.debug({ siteIds }, `Discovered ${siteIds.length} site(s)`);
+    }
+    if (siteIds.length === 0) {
+        return { features: [], execution: undefined };
+    }
+    // Build export configuration for all sites with commerce_feature_states
+    const sitesConfig = {};
+    for (const siteId of siteIds) {
+        sitesConfig[siteId] = { commerce_feature_states: true };
+    }
+    logger.debug({ siteIds }, 'Exporting commerce_feature_states');
+    const exportResult = await siteArchiveExportToBuffer(instance, { sites: sitesConfig }, { waitOptions });
+    const states = await parseExportArchive(exportResult.data);
+    return { features: states, execution: exportResult.execution };
+}
+/**
+ * Parses a site archive export zip for commerce-feature-states.xml files.
+ */
+async function parseExportArchive(data) {
+    const logger = getLogger();
+    const zip = await JSZip.loadAsync(data);
+    const states = [];
+    const filePaths = Object.keys(zip.files).filter((p) => !zip.files[p].dir);
+    logger.debug({ filePaths }, `Export archive contains ${filePaths.length} file(s)`);
+    for (const [filePath, entry] of Object.entries(zip.files)) {
+        if (entry.dir)
+            continue;
+        const match = filePath.match(/sites\/([^/]+)\/commerce-feature-states\.xml$/);
+        if (match) {
+            const siteId = match[1];
+            const xml = await entry.async('string');
+            const parsed = await parseCommerceFeatureStatesXml(xml, siteId);
+            states.push(...parsed);
+        }
+    }
+    return states;
+}
+/**
+ * Parses a commerce-feature-states.xml string into CommerceFeatureState objects.
+ *
+ * @param xml - XML string to parse
+ * @param siteId - Site ID to associate with parsed states (used as fallback if not in XML attributes)
+ * @returns Array of parsed commerce feature states
+ */
+export async function parseCommerceFeatureStatesXml(xml, siteId) {
+    const parsed = await xml2js.parseStringPromise(xml, {
+        explicitArray: false,
+        tagNameProcessors: [(name) => name.replace(/^[^:]+:/, '')],
+    });
+    if (!parsed)
+        return [];
+    const root = parsed['commerce-feature-states'];
+    if (!root)
+        return [];
+    let entries = root['commerce-feature-state'];
+    if (!entries)
+        return [];
+    // Normalize to array (xml2js uses single object when there's only one element)
+    if (!Array.isArray(entries)) {
+        entries = [entries];
+    }
+    return entries.map((entry) => {
+        const attrs = (entry['$'] ?? {});
+        // Parse config-tasks as JSON if present
+        let configTasks;
+        if (typeof entry['config-tasks'] === 'string') {
+            try {
+                configTasks = JSON.parse(entry['config-tasks']);
+            }
+            catch {
+                // Leave as undefined if not valid JSON
+            }
+        }
+        // Parse installation-metadata as JSON if present
+        let installationMetadata;
+        if (typeof entry['installation-metadata'] === 'string') {
+            try {
+                const parsed = JSON.parse(entry['installation-metadata']);
+                if (typeof parsed.impexUninstallData === 'string') {
+                    try {
+                        parsed.impexUninstallData = JSON.parse(parsed.impexUninstallData);
+                    }
+                    catch {
+                        // leave as string
+                    }
+                }
+                installationMetadata = parsed;
+            }
+            catch {
+                // Leave as undefined if not valid JSON
+            }
+        }
+        return {
+            siteId: attrs['site-id'] || siteId,
+            featureName: attrs['feature-name'] || '',
+            featureType: getTextValue(entry['feature-type']),
+            featureSource: getTextValue(entry['feature-source']),
+            featureDomain: getTextValue(entry['feature-domain']),
+            installStatus: getTextValue(entry['install-status']),
+            configStatus: getTextValue(entry['config-status']),
+            featureVersionId: getTextValue(entry['feature-version-id']),
+            installedAt: getTextValue(entry['installed-at']),
+            configTasks,
+            installationMetadata,
+        };
+    });
+}
+/** Extract text value from xml2js parsed element (may be string or object with _). */
+function getTextValue(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value && typeof value === 'object' && '_' in value) {
+        return String(value['_']);
+    }
+    return '';
+}
+//# sourceMappingURL=list.js.map

package/dist/esm/operations/cap/list.js.map

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

package/dist/esm/operations/cap/package.d.ts

@@ -0,0 +1,39 @@
+import { type CommerceAppManifest } from './validate.js';
+/**
+ * Options for CAP packaging.
+ */
+export interface CommerceAppPackageOptions {
+    /**
+     * Output path for the zip file.
+     * - If a directory: zip is written to `{outputPath}/{id}-v{version}.zip`
+     * - If a .zip path: written to that exact location
+     * - Default: current working directory
+     */
+    outputPath?: string;
+}
+/**
+ * Result of CAP packaging.
+ */
+export interface CommerceAppPackageResult {
+    /** Absolute path to the produced zip file. */
+    outputPath: string;
+    /** Parsed manifest. */
+    manifest: CommerceAppManifest;
+}
+/**
+ * Packages a CAP directory into a distributable .zip file.
+ *
+ * The zip root directory is named `{id}-v{version}/` as required by the CAP spec.
+ * Reads commerce-app.json to determine the app name and version.
+ *
+ * @param sourceDir - Path to the CAP directory
+ * @param options - Packaging options
+ * @returns Result with the output zip path and manifest
+ *
+ * @example
+ * ```typescript
+ * const result = await commerceAppPackage('./commerce-avalara-tax-app-v0.2.5');
+ * console.log(`Packaged to: ${result.outputPath}`);
+ * ```
+ */
+export declare function commerceAppPackage(sourceDir: string, options?: CommerceAppPackageOptions): Promise<CommerceAppPackageResult>;

package/dist/esm/operations/cap/package.js

@@ -0,0 +1,78 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Commerce App Package (CAP) packaging.
+ *
+ * Zips a CAP directory into a distributable .zip file with the correct
+ * root directory naming convention ({id}-v{version}/).
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import JSZip from 'jszip';
+import { getLogger } from '../../logging/logger.js';
+import { addDirectoryToZip } from '../util/zip.js';
+import { readManifest } from './install.js';
+import {} from './validate.js';
+/**
+ * Packages a CAP directory into a distributable .zip file.
+ *
+ * The zip root directory is named `{id}-v{version}/` as required by the CAP spec.
+ * Reads commerce-app.json to determine the app name and version.
+ *
+ * @param sourceDir - Path to the CAP directory
+ * @param options - Packaging options
+ * @returns Result with the output zip path and manifest
+ *
+ * @example
+ * ```typescript
+ * const result = await commerceAppPackage('./commerce-avalara-tax-app-v0.2.5');
+ * console.log(`Packaged to: ${result.outputPath}`);
+ * ```
+ */
+export async function commerceAppPackage(sourceDir, options = {}) {
+    const logger = getLogger();
+    if (!fs.existsSync(sourceDir)) {
+        throw new Error(`Source directory not found: ${sourceDir}`);
+    }
+    if (!fs.statSync(sourceDir).isDirectory()) {
+        throw new Error(`Source must be a directory: ${sourceDir}`);
+    }
+    const manifest = readManifest(sourceDir);
+    if (!manifest.id || !manifest.version) {
+        throw new Error('commerce-app.json must have "id" and "version" fields');
+    }
+    const archiveDirName = `${manifest.id}-v${manifest.version}`;
+    const zipFilename = `${archiveDirName}.zip`;
+    // Determine output path
+    let outputZipPath;
+    if (!options.outputPath) {
+        outputZipPath = path.resolve(process.cwd(), zipFilename);
+    }
+    else {
+        const resolved = path.resolve(options.outputPath);
+        if (resolved.endsWith('.zip')) {
+            outputZipPath = resolved;
+        }
+        else {
+            outputZipPath = path.join(resolved, zipFilename);
+        }
+    }
+    // Ensure output directory exists
+    await fs.promises.mkdir(path.dirname(outputZipPath), { recursive: true });
+    logger.debug({ sourceDir, outputPath: outputZipPath }, `Packaging CAP: ${archiveDirName}`);
+    const zip = new JSZip();
+    const rootFolder = zip.folder(archiveDirName);
+    await addDirectoryToZip(rootFolder, sourceDir);
+    const buffer = await zip.generateAsync({
+        type: 'nodebuffer',
+        compression: 'DEFLATE',
+        compressionOptions: { level: 9 },
+    });
+    await fs.promises.writeFile(outputZipPath, buffer);
+    logger.debug({ outputPath: outputZipPath }, `CAP packaged to: ${outputZipPath}`);
+    return { outputPath: outputZipPath, manifest };
+}
+//# sourceMappingURL=package.js.map

package/dist/esm/operations/cap/package.js.map

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

package/dist/esm/operations/cap/pull.d.ts

@@ -0,0 +1,21 @@
+import { B2CInstance } from '../../instance/index.js';
+import type { CommerceFeatureState } from './list.js';
+export interface PullCommerceAppsOptions {
+    outputDir?: string;
+}
+export type PullSource = 'instance' | 'github';
+export interface PulledApp {
+    featureName: string;
+    version: string;
+    domain: string;
+    source: PullSource;
+    extractedPath: string;
+}
+export interface PullCommerceAppsResult {
+    pulled: PulledApp[];
+    failed: Array<{
+        featureName: string;
+        error: string;
+    }>;
+}
+export declare function pullCommerceApps(instance: B2CInstance, features: CommerceFeatureState[], options?: PullCommerceAppsOptions): Promise<PullCommerceAppsResult>;

package/dist/esm/operations/cap/pull.js

@@ -0,0 +1,78 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import JSZip from 'jszip';
+import { B2CInstance } from '../../instance/index.js';
+import { getLogger } from '../../logging/logger.js';
+const GITHUB_RAW_BASE = 'https://raw.githubusercontent.com/SalesforceCommerceCloud/commerce-apps/main';
+export async function pullCommerceApps(instance, features, options = {}) {
+    const logger = getLogger();
+    const outputDir = path.resolve(options.outputDir ?? 'commerce-apps');
+    await fs.promises.mkdir(outputDir, { recursive: true });
+    const pulled = [];
+    const failed = [];
+    for (const feature of features) {
+        const { featureName, featureVersionId, featureDomain } = feature;
+        if (!featureVersionId) {
+            failed.push({ featureName, error: 'No version available' });
+            continue;
+        }
+        const zipFilename = `${featureName}-v${featureVersionId}.zip`;
+        const webdavPath = `Impex/commerce-apps/${zipFilename}`;
+        let zipData = null;
+        let source = 'instance';
+        // Try instance first
+        if (await instance.webdav.exists(webdavPath)) {
+            logger.debug({ path: webdavPath }, `Downloading ${zipFilename} from instance`);
+            zipData = Buffer.from(await instance.webdav.get(webdavPath));
+        }
+        // Fall back to GitHub
+        if (!zipData) {
+            const githubUrl = `${GITHUB_RAW_BASE}/${featureDomain}/${featureName}/${zipFilename}`;
+            logger.warn({ url: githubUrl }, `${zipFilename} not found on instance, trying GitHub`);
+            source = 'github';
+            try {
+                const response = await fetch(githubUrl);
+                if (!response.ok) {
+                    failed.push({ featureName, error: `Not found on instance or GitHub (${githubUrl})` });
+                    continue;
+                }
+                zipData = Buffer.from(await response.arrayBuffer());
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                failed.push({ featureName, error: `GitHub download failed: ${msg}` });
+                continue;
+            }
+        }
+        // Extract zip
+        const zip = await JSZip.loadAsync(zipData);
+        const extractDir = path.join(outputDir, featureName);
+        await fs.promises.mkdir(extractDir, { recursive: true });
+        for (const [filePath, entry] of Object.entries(zip.files)) {
+            if (entry.dir)
+                continue;
+            // Strip the top-level archive directory (e.g. "avalara-tax-v1.1.0/...")
+            const parts = filePath.split('/');
+            const relativePath = parts.length > 1 ? parts.slice(1).join('/') : filePath;
+            const fullPath = path.join(extractDir, relativePath);
+            await fs.promises.mkdir(path.dirname(fullPath), { recursive: true });
+            const content = await entry.async('nodebuffer');
+            await fs.promises.writeFile(fullPath, content);
+        }
+        logger.debug({ featureName, extractDir }, `Extracted ${featureName} to ${extractDir}`);
+        pulled.push({
+            featureName,
+            version: featureVersionId,
+            domain: featureDomain,
+            source,
+            extractedPath: extractDir,
+        });
+    }
+    return { pulled, failed };
+}
+//# sourceMappingURL=pull.js.map

package/dist/esm/operations/cap/pull.js.map

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

package/dist/esm/operations/cap/uninstall.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Commerce App Package (CAP) uninstallation.
+ *
+ * Runs the sfcc-uninstall-commerce-app system job to remove an installed CAP.
+ */
+import { B2CInstance } from '../../instance/index.js';
+import { type JobExecution, type WaitForJobOptions } from '../jobs/run.js';
+/**
+ * Options for CAP uninstallation.
+ */
+export interface CommerceAppUninstallOptions {
+    /** Target site ID to uninstall the app from. */
+    siteId: string;
+    /** Wait options for job completion. */
+    waitOptions?: WaitForJobOptions;
+}
+/**
+ * Result of a CAP uninstallation.
+ */
+export interface CommerceAppUninstallResult {
+    /** Job execution details. */
+    execution: JobExecution;
+    /** App name that was uninstalled. */
+    appName: string;
+}
+/**
+ * Uninstalls a Commerce App from a B2C Commerce instance.
+ *
+ * Executes the sfcc-uninstall-commerce-app system job which removes cartridges,
+ * IMPEX data, and configuration associated with the app from the target site.
+ *
+ * @param instance - B2C instance to uninstall from
+ * @param appName - App ID (from commerce-app.json "id" field, e.g. "avalara-tax")
+ * @param appDomain - App domain (e.g. "tax", "shipping")
+ * @param options - Uninstall options including required siteId
+ * @returns Uninstall result with job execution details
+ * @throws JobExecutionError if the uninstall job fails
+ *
+ * @example
+ * ```typescript
+ * const result = await commerceAppUninstall(instance, 'avalara-tax', 'tax', {
+ *   siteId: 'RefArch',
+ * });
+ * ```
+ */
+export declare function commerceAppUninstall(instance: B2CInstance, appName: string, appDomain: string, options: CommerceAppUninstallOptions): Promise<CommerceAppUninstallResult>;

package/dist/esm/operations/cap/uninstall.js

@@ -0,0 +1,98 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Commerce App Package (CAP) uninstallation.
+ *
+ * Runs the sfcc-uninstall-commerce-app system job to remove an installed CAP.
+ */
+import { B2CInstance } from '../../instance/index.js';
+import { getLogger } from '../../logging/logger.js';
+import { waitForJob, JobExecutionError, getJobLog } from '../jobs/run.js';
+import { normalizeSiteId } from './install.js';
+const UNINSTALL_JOB_ID = 'sfcc-uninstall-commerce-app';
+/**
+ * Uninstalls a Commerce App from a B2C Commerce instance.
+ *
+ * Executes the sfcc-uninstall-commerce-app system job which removes cartridges,
+ * IMPEX data, and configuration associated with the app from the target site.
+ *
+ * @param instance - B2C instance to uninstall from
+ * @param appName - App ID (from commerce-app.json "id" field, e.g. "avalara-tax")
+ * @param appDomain - App domain (e.g. "tax", "shipping")
+ * @param options - Uninstall options including required siteId
+ * @returns Uninstall result with job execution details
+ * @throws JobExecutionError if the uninstall job fails
+ *
+ * @example
+ * ```typescript
+ * const result = await commerceAppUninstall(instance, 'avalara-tax', 'tax', {
+ *   siteId: 'RefArch',
+ * });
+ * ```
+ */
+export async function commerceAppUninstall(instance, appName, appDomain, options) {
+    const logger = getLogger();
+    const { siteId: rawSiteId, waitOptions } = options;
+    const siteId = normalizeSiteId(rawSiteId);
+    logger.debug({ jobId: UNINSTALL_JOB_ID, appName, siteId }, `Executing ${UNINSTALL_JOB_ID} job`);
+    let execution;
+    // Try direct body format first (standard OCAPI format)
+    const { data, error } = await instance.ocapi.POST('/jobs/{job_id}/executions', {
+        params: { path: { job_id: UNINSTALL_JOB_ID } },
+        body: {
+            app_name: appName,
+            app_domain: appDomain,
+            site_id: siteId,
+        },
+    });
+    if (error?.fault?.type === 'UnknownPropertyException' &&
+        error.fault.arguments?.document === 'job_execution_request') {
+        // Retry with parameters format (internal/support users)
+        logger.warn('Retrying with parameters format for internal users');
+        const { data: retryData, error: retryError } = await instance.ocapi.POST('/jobs/{job_id}/executions', {
+            params: { path: { job_id: UNINSTALL_JOB_ID } },
+            body: {
+                parameters: [
+                    { name: 'AppName', value: appName },
+                    { name: 'AppDomain', value: appDomain },
+                    { name: 'SiteId', value: siteId },
+                ],
+            },
+        });
+        if (retryError || !retryData) {
+            throw new Error(retryError?.fault?.message ?? 'Failed to start uninstall job');
+        }
+        execution = retryData;
+    }
+    else if (error || !data) {
+        throw new Error(error?.fault?.message ?? 'Failed to start uninstall job');
+    }
+    else {
+        execution = data;
+    }
+    logger.debug({ jobId: UNINSTALL_JOB_ID, executionId: execution.id }, `Uninstall job started: ${execution.id}`);
+    let finalExecution;
+    try {
+        finalExecution = await waitForJob(instance, UNINSTALL_JOB_ID, execution.id, waitOptions);
+    }
+    catch (err) {
+        if (err instanceof JobExecutionError) {
+            try {
+                const log = await getJobLog(instance, err.execution);
+                logger.error({ jobId: UNINSTALL_JOB_ID, log }, `Job log:\n${log}`);
+            }
+            catch {
+                logger.error({ jobId: UNINSTALL_JOB_ID }, 'Could not retrieve job log');
+            }
+        }
+        throw err;
+    }
+    return {
+        execution: finalExecution,
+        appName,
+    };
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/esm/operations/cap/uninstall.js.map

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