@deenruv/merchant-plugin 1.0.17-dev.18 → 1.0.17-dev.23

package/README.md

@@ -41,11 +41,22 @@ Google settings page requires:
 - `credentials` — Google OAuth credential JSON for a service account or an
   authorized user. Store and distribute this value as a secret.
 - `brand` — the brand applied to exported product attributes.
+- `contentLanguage` — two-letter product language code (defaults to `pl`).
+- `feedLabel` — Merchant Center feed label (defaults to `PL`).
+
+`publicBaseUrl` is supplied by the export strategy. It must produce absolute,
+publicly reachable `http` or `https` product and image URLs. The example server
+reads it from `PUBLIC_URL`, then `HOST_URL`, and only falls back to localhost in
+local development.
 
 Product inputs are written only to the configured data source. Merchant API
 processing is asynchronous, so a processed product might not be readable for
 several minutes after a successful write.
 
+After upgrading an existing installation, generate and run a database migration
+for the new `merchant_sync_run` and `merchant_sync_item` history tables before
+starting workers.
+
 #### Deployment prerequisites (documentation only)
 
 An operator must complete the following outside this plugin and outside the
@@ -67,6 +78,9 @@ data sources, change Merchant Center configuration, or provision credentials:
 - Google Merchant Center integration via Merchant API Products v1
 - Facebook Commerce integration via Facebook Business SDK
 - Per-platform settings storage and management
+- Live account and data-source connection diagnostics
+- Persistent synchronization run and per-product error history
+- Retried, queued, idempotent Google product updates
 - Bulk product sync to merchant platforms
 - Orphan item cleanup for removed products
 - `communicateID` custom field on ProductVariant for platform communication tracking

package/dist/plugin-server/api/platform-integration-admin-resolver.d.ts

@@ -14,13 +14,32 @@ export declare class PlatformIntegrationAdminResolver {
     getMerchantPlatformInfo(ctx: RequestContext, args: {
         platform: string;
     }): Promise<{
+        isValidConnection: boolean;
+        checkedAt: string;
+        connectionStatus: import("../services/google-merchant-api.js").GoogleMerchantConnectionStatus;
+        dataSourceVerified: boolean;
+        disapprovedProductsCount: number;
+        issues: import("../services/google-merchant-api.js").GoogleMerchantProductIssue[];
+        issuesCount: number;
+        lastError?: Omit<import("../services/google-merchant-api.js").NormalizedGoogleMerchantError, "status"> | undefined;
+        latencyMs: number;
+        productsCount: number;
+    }[] | {
         productsCount: number;
         isValidConnection: boolean;
     }[]>;
+    sendAllProductsToMerchantPlatform(ctx: RequestContext, args: {
+        platform: string;
+    }): Promise<boolean>;
+    getMerchantSyncHistory(ctx: RequestContext, args: {
+        platform: string;
+        take?: number;
+    }): Promise<import("../entities/merchant-sync-run.entity.js").MerchantSyncRun[]>;
     saveMerchantPlatformSettings(ctx: RequestContext, args: {
         input: MerchantPlatformSettingsEntity;
-    }): Promise<MerchantPlatformSettingsEntity | undefined>;
+    }): Promise<MerchantPlatformSettingsEntity>;
     removeOrphanItems(ctx: RequestContext, args: {
         platform: string;
     }): Promise<boolean>;
+    private redactCredentials;
 }

package/dist/plugin-server/api/platform-integration-admin-resolver.js

@@ -26,28 +26,17 @@ let PlatformIntegrationAdminResolver = class PlatformIntegrationAdminResolver {
         this.facebookPlatformIntegrationService = facebookPlatformIntegrationService;
         this.platformIntegrationService = platformIntegrationService;
     }
-    getMerchantPlatformSettings(ctx, args) {
-        return this.platformIntegrationService.getBaseSettings(ctx, args.platform);
+    async getMerchantPlatformSettings(ctx, args) {
+        const settings = await this.platformIntegrationService.getBaseSettings(ctx, args.platform);
+        return settings ? this.redactCredentials(settings) : null;
     }
     async getMerchantPlatformInfo(ctx, args) {
         var _a;
         const settings = await this.platformIntegrationService.getBaseSettings(ctx, args.platform);
         if (args.platform === "google") {
-            let isValidConnection = false;
-            if (settings) {
-                try {
-                    this.googlePlatformIntegrationService.validateGoogleSettings(settings);
-                    isValidConnection = true;
-                }
-                catch (_b) {
-                    isValidConnection = false;
-                }
-            }
+            const diagnostic = await this.googlePlatformIntegrationService.getConnectionDiagnostic(ctx);
             return [
-                {
-                    productsCount: 0,
-                    isValidConnection,
-                },
+                Object.assign(Object.assign({}, diagnostic), { isValidConnection: diagnostic.connectionStatus === "CONNECTED" }),
             ];
         }
         if (args.platform === "facebook") {
@@ -60,20 +49,40 @@ let PlatformIntegrationAdminResolver = class PlatformIntegrationAdminResolver {
         }
         return [{ productsCount: 0, isValidConnection: false }];
     }
+    async sendAllProductsToMerchantPlatform(ctx, args) {
+        return this.platformIntegrationService.enqueueFullSync(ctx, args.platform);
+    }
+    async getMerchantSyncHistory(ctx, args) {
+        return this.platformIntegrationService.getSyncHistory(ctx, args.platform, args.take);
+    }
     async saveMerchantPlatformSettings(ctx, args) {
+        var _a, _b;
+        let entries = args.input.entries;
+        if (args.input.platform === "google" &&
+            ((_a = entries.find((entry) => entry.key === "credentials")) === null || _a === void 0 ? void 0 : _a.value) === "") {
+            const existing = await this.platformIntegrationService.getBaseSettings(ctx, "google");
+            const existingCredentials = (_b = existing === null || existing === void 0 ? void 0 : existing.entries.find((entry) => entry.key === "credentials")) === null || _b === void 0 ? void 0 : _b.value;
+            if (existingCredentials) {
+                entries = entries.map((entry) => entry.key === "credentials"
+                    ? Object.assign(Object.assign({}, entry), { value: existingCredentials }) : entry);
+            }
+        }
         const settingsEntity = new platform_integration_settings_entity_js_1.MerchantPlatformSettingsEntity({
             platform: args.input.platform,
-            entries: args.input.entries.map((entry) => new platform_integration_setting_entity_js_1.MerchantPlatformSetting(entry)),
+            entries: entries.map((entry) => new platform_integration_setting_entity_js_1.MerchantPlatformSetting(entry)),
         });
         if (settingsEntity.platform === "google") {
             this.googlePlatformIntegrationService.validateGoogleSettings(settingsEntity);
         }
         const settings = await this.platformIntegrationService.savePlatformIntegrationSettings(ctx, settingsEntity);
-        return settings;
+        return settings ? this.redactCredentials(settings) : settings;
     }
     async removeOrphanItems(ctx, args) {
         return this.platformIntegrationService.removeOrphanItems(ctx, args.platform);
     }
+    redactCredentials(settings) {
+        return Object.assign(Object.assign({}, settings), { entries: settings.entries.map((entry) => entry.key === "credentials" ? Object.assign(Object.assign({}, entry), { value: "" }) : entry) });
+    }
 };
 exports.PlatformIntegrationAdminResolver = PlatformIntegrationAdminResolver;
 __decorate([
@@ -82,7 +91,7 @@ __decorate([
     __param(1, (0, graphql_1.Args)()),
     __metadata("design:type", Function),
     __metadata("design:paramtypes", [core_1.RequestContext, Object]),
-    __metadata("design:returntype", void 0)
+    __metadata("design:returntype", Promise)
 ], PlatformIntegrationAdminResolver.prototype, "getMerchantPlatformSettings", null);
 __decorate([
     (0, graphql_1.Query)(),
@@ -92,6 +101,22 @@ __decorate([
     __metadata("design:paramtypes", [core_1.RequestContext, Object]),
     __metadata("design:returntype", Promise)
 ], PlatformIntegrationAdminResolver.prototype, "getMerchantPlatformInfo", null);
+__decorate([
+    (0, graphql_1.Mutation)(),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, graphql_1.Args)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, Object]),
+    __metadata("design:returntype", Promise)
+], PlatformIntegrationAdminResolver.prototype, "sendAllProductsToMerchantPlatform", null);
+__decorate([
+    (0, graphql_1.Query)(),
+    __param(0, (0, core_1.Ctx)()),
+    __param(1, (0, graphql_1.Args)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [core_1.RequestContext, Object]),
+    __metadata("design:returntype", Promise)
+], PlatformIntegrationAdminResolver.prototype, "getMerchantSyncHistory", null);
 __decorate([
     (0, graphql_1.Mutation)(),
     __param(0, (0, core_1.Ctx)()),

package/dist/plugin-server/entities/merchant-sync-item.entity.d.ts

@@ -0,0 +1,14 @@
+import { DeepPartial } from "@deenruv/common/lib/shared-types.js";
+import { DeenruvEntity } from "@deenruv/core";
+import type { Relation } from "typeorm";
+import { MerchantSyncRun } from "./merchant-sync-run.entity.js";
+export declare class MerchantSyncItem extends DeenruvEntity {
+    constructor(input?: DeepPartial<MerchantSyncItem>);
+    offerId: string;
+    operation: string;
+    status: string;
+    errorCode: string | null;
+    errorMessage: string | null;
+    attempts: number;
+    run: Relation<MerchantSyncRun>;
+}

package/dist/plugin-server/entities/merchant-sync-item.entity.js

@@ -0,0 +1,56 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MerchantSyncItem = void 0;
+const core_1 = require("@deenruv/core");
+const typeorm_1 = require("typeorm");
+const merchant_sync_run_entity_js_1 = require("./merchant-sync-run.entity.js");
+let MerchantSyncItem = class MerchantSyncItem extends core_1.DeenruvEntity {
+    constructor(input) {
+        super(input);
+    }
+};
+exports.MerchantSyncItem = MerchantSyncItem;
+__decorate([
+    (0, typeorm_1.Column)({ type: "varchar" }),
+    __metadata("design:type", String)
+], MerchantSyncItem.prototype, "offerId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: "varchar" }),
+    __metadata("design:type", String)
+], MerchantSyncItem.prototype, "operation", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: "varchar" }),
+    __metadata("design:type", String)
+], MerchantSyncItem.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true, type: "varchar" }),
+    __metadata("design:type", Object)
+], MerchantSyncItem.prototype, "errorCode", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: "text", nullable: true }),
+    __metadata("design:type", Object)
+], MerchantSyncItem.prototype, "errorMessage", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ default: 1, type: "int" }),
+    __metadata("design:type", Number)
+], MerchantSyncItem.prototype, "attempts", void 0);
+__decorate([
+    (0, typeorm_1.ManyToOne)(() => merchant_sync_run_entity_js_1.MerchantSyncRun, (run) => run.items, {
+        onDelete: "CASCADE",
+    }),
+    __metadata("design:type", Object)
+], MerchantSyncItem.prototype, "run", void 0);
+exports.MerchantSyncItem = MerchantSyncItem = __decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)(["offerId", "createdAt"]),
+    __metadata("design:paramtypes", [Object])
+], MerchantSyncItem);

package/dist/plugin-server/entities/merchant-sync-run.entity.d.ts

@@ -0,0 +1,19 @@
+import { DeepPartial } from "@deenruv/common/lib/shared-types.js";
+import { DeenruvEntity } from "@deenruv/core";
+import type { Relation } from "typeorm";
+import { MerchantSyncItem } from "./merchant-sync-item.entity.js";
+export type MerchantSyncRunStatus = "PENDING" | "RUNNING" | "SUCCESS" | "PARTIAL" | "FAILED";
+export declare class MerchantSyncRun extends DeenruvEntity {
+    constructor(input?: DeepPartial<MerchantSyncRun>);
+    platform: string;
+    trigger: string;
+    status: MerchantSyncRunStatus;
+    jobId: string | null;
+    total: number;
+    succeeded: number;
+    failed: number;
+    errorSummary: string | null;
+    startedAt: Date | null;
+    finishedAt: Date | null;
+    items: Relation<MerchantSyncItem[]>;
+}

package/dist/plugin-server/entities/merchant-sync-run.entity.js

@@ -0,0 +1,72 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MerchantSyncRun = void 0;
+const core_1 = require("@deenruv/core");
+const typeorm_1 = require("typeorm");
+const merchant_sync_item_entity_js_1 = require("./merchant-sync-item.entity.js");
+let MerchantSyncRun = class MerchantSyncRun extends core_1.DeenruvEntity {
+    constructor(input) {
+        super(input);
+    }
+};
+exports.MerchantSyncRun = MerchantSyncRun;
+__decorate([
+    (0, typeorm_1.Column)({ type: "varchar" }),
+    __metadata("design:type", String)
+], MerchantSyncRun.prototype, "platform", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: "varchar" }),
+    __metadata("design:type", String)
+], MerchantSyncRun.prototype, "trigger", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ default: "PENDING", type: "varchar" }),
+    __metadata("design:type", String)
+], MerchantSyncRun.prototype, "status", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ nullable: true, type: "varchar" }),
+    __metadata("design:type", Object)
+], MerchantSyncRun.prototype, "jobId", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ default: 0, type: "int" }),
+    __metadata("design:type", Number)
+], MerchantSyncRun.prototype, "total", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ default: 0, type: "int" }),
+    __metadata("design:type", Number)
+], MerchantSyncRun.prototype, "succeeded", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ default: 0, type: "int" }),
+    __metadata("design:type", Number)
+], MerchantSyncRun.prototype, "failed", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: "text", nullable: true }),
+    __metadata("design:type", Object)
+], MerchantSyncRun.prototype, "errorSummary", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: "timestamp", nullable: true }),
+    __metadata("design:type", Object)
+], MerchantSyncRun.prototype, "startedAt", void 0);
+__decorate([
+    (0, typeorm_1.Column)({ type: "timestamp", nullable: true }),
+    __metadata("design:type", Object)
+], MerchantSyncRun.prototype, "finishedAt", void 0);
+__decorate([
+    (0, typeorm_1.OneToMany)(() => merchant_sync_item_entity_js_1.MerchantSyncItem, (item) => item.run, {
+        cascade: true,
+    }),
+    __metadata("design:type", Object)
+], MerchantSyncRun.prototype, "items", void 0);
+exports.MerchantSyncRun = MerchantSyncRun = __decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)(["platform", "createdAt"]),
+    __metadata("design:paramtypes", [Object])
+], MerchantSyncRun);

package/dist/plugin-server/extensions/api-extensions.js

@@ -11,12 +11,59 @@ const base = (0, graphql_tag_1.gql) `
   type MerchantPlatformSettingsEntity implements Node {
     id: ID!
     platform: String!
-    entries: [MerchantPlatformSetting!]
+    entries: [MerchantPlatformSetting!]!
   }
 
   type MerchantPlatformInfo {
     isValidConnection: Boolean!
     productsCount: Int!
+    connectionStatus: String
+    dataSourceVerified: Boolean
+    checkedAt: DateTime
+    latencyMs: Int
+    disapprovedProductsCount: Int
+    issuesCount: Int
+    lastError: MerchantPlatformError
+    issues: [MerchantProductIssue!]
+  }
+
+  type MerchantPlatformError {
+    code: String!
+    message: String!
+    retryable: Boolean!
+  }
+
+  type MerchantProductIssue {
+    offerId: String!
+    code: String!
+    description: String!
+    severity: String!
+  }
+
+  type MerchantSyncItem {
+    id: ID!
+    offerId: String!
+    operation: String!
+    status: String!
+    errorCode: String
+    errorMessage: String
+    attempts: Int!
+  }
+
+  type MerchantSyncRun {
+    id: ID!
+    createdAt: DateTime!
+    platform: String!
+    trigger: String!
+    status: String!
+    jobId: String
+    total: Int!
+    succeeded: Int!
+    failed: Int!
+    errorSummary: String
+    startedAt: DateTime
+    finishedAt: DateTime
+    items: [MerchantSyncItem!]!
   }
 `;
 exports.adminApiExtensions = (0, graphql_tag_1.gql) `
@@ -29,7 +76,7 @@ exports.adminApiExtensions = (0, graphql_tag_1.gql) `
 
   input SaveMerchantPlatformSettingInput {
     platform: String!
-    entries: [MerchantPlatformSettingInput!]
+    entries: [MerchantPlatformSettingInput!]!
   }
 
   extend type Mutation {
@@ -45,5 +92,9 @@ exports.adminApiExtensions = (0, graphql_tag_1.gql) `
       platform: String!
     ): MerchantPlatformSettingsEntity
     getMerchantPlatformInfo(platform: String!): [MerchantPlatformInfo!]
+    getMerchantSyncHistory(
+      platform: String!
+      take: Int
+    ): [MerchantSyncRun!]!
   }
 `;

package/dist/plugin-server/index.js

@@ -16,10 +16,13 @@ const platform_integration_admin_resolver_js_1 = require("./api/platform-integra
 const constants_js_1 = require("./constants.js");
 const platform_integration_setting_entity_js_1 = require("./entities/platform-integration-setting.entity.js");
 const platform_integration_settings_entity_js_1 = require("./entities/platform-integration-settings.entity.js");
+const merchant_sync_item_entity_js_1 = require("./entities/merchant-sync-item.entity.js");
+const merchant_sync_run_entity_js_1 = require("./entities/merchant-sync-run.entity.js");
 const api_extensions_js_1 = require("./extensions/api-extensions.js");
 const facebook_platform_integration_service_js_1 = require("./services/facebook-platform-integration.service.js");
 const google_platform_integration_service_js_1 = require("./services/google-platform-integration.service.js");
 const merchant_strategy_service_js_1 = require("./services/merchant-strategy.service.js");
+const merchant_sync_history_service_js_1 = require("./services/merchant-sync-history.service.js");
 const platform_integration_service_js_1 = require("./services/platform-integration.service.js");
 const subscriber_service_js_1 = require("./services/subscriber.service.js");
 let MerchantPlugin = class MerchantPlugin {
@@ -56,7 +59,12 @@ exports.MerchantPlugin = MerchantPlugin = __decorate([
     (0, core_1.DeenruvPlugin)({
         compatibility: "^2.0.0",
         imports: [core_1.PluginCommonModule],
-        entities: [platform_integration_setting_entity_js_1.MerchantPlatformSetting, platform_integration_settings_entity_js_1.MerchantPlatformSettingsEntity],
+        entities: [
+            platform_integration_setting_entity_js_1.MerchantPlatformSetting,
+            platform_integration_settings_entity_js_1.MerchantPlatformSettingsEntity,
+            merchant_sync_run_entity_js_1.MerchantSyncRun,
+            merchant_sync_item_entity_js_1.MerchantSyncItem,
+        ],
         shopApiExtensions: {},
         adminApiExtensions: {
             schema: api_extensions_js_1.adminApiExtensions,
@@ -68,6 +76,7 @@ exports.MerchantPlugin = MerchantPlugin = __decorate([
                 useFactory: () => MerchantPlugin.options,
             },
             merchant_strategy_service_js_1.MerchantStrategyService,
+            merchant_sync_history_service_js_1.MerchantSyncHistoryService,
             platform_integration_service_js_1.PlatformIntegrationService,
             google_platform_integration_service_js_1.GooglePlatformIntegrationService,
             facebook_platform_integration_service_js_1.FacebookPlatformIntegrationService,

package/dist/plugin-server/services/google-merchant-api.d.ts

@@ -1,4 +1,5 @@
 import { v1 } from "@google-shopping/products";
+import { v1 as dataSourcesV1 } from "@google-shopping/datasources";
 import type { protos } from "@google-shopping/products";
 import type { GoogleProcessedProduct, GoogleProduct, GoogleProductInput, RemoteProduct } from "../types.js";
 export declare const GOOGLE_CONTENT_LANGUAGE = "pl";
@@ -12,8 +13,11 @@ export type GoogleMerchantSettings = {
     brand: string;
     credentials: GoogleMerchantCredentials;
     dataSource: string;
+    contentLanguage: string;
+    feedLabel: string;
 };
 export type GoogleMerchantClients = {
+    dataSources: dataSourcesV1.DataSourcesServiceClient;
     productInputs: v1.ProductInputsServiceClient;
     products: v1.ProductsServiceClient;
 };
@@ -35,10 +39,12 @@ export type GoogleWriteOperation = {
     request: DeleteProductInputRequest;
 };
 export type MerchantOperationResult<T> = {
+    attempts: number;
     index: number;
     item: T;
     status: "success";
 } | {
+    attempts: number;
     error: unknown;
     index: number;
     item: T;
@@ -59,26 +65,62 @@ export interface GoogleProductInputsWriter {
 export interface GoogleProductsReader {
     listProductsAsync(request: ListProductsRequest): AsyncIterable<GoogleProcessedProduct>;
 }
+export interface GoogleDataSourcesReader {
+    getDataSource(request: {
+        name: string;
+    }): Promise<unknown>;
+}
+export type GoogleMerchantRetryOptions = {
+    delay?: (attempt: number) => Promise<void>;
+    maxAttempts?: number;
+};
+export type GoogleMerchantConnectionStatus = "CONNECTED" | "NOT_CONFIGURED" | "INVALID_CONFIGURATION" | "DATA_SOURCE_NOT_FOUND" | "AUTHENTICATION_FAILED" | "PERMISSION_DENIED" | "UNAVAILABLE" | "ERROR";
+export type GoogleMerchantProductIssue = {
+    code: string;
+    description: string;
+    offerId: string;
+    severity: string;
+};
+export type GoogleMerchantConnectionDiagnostic = {
+    checkedAt: string;
+    connectionStatus: GoogleMerchantConnectionStatus;
+    dataSourceVerified: boolean;
+    disapprovedProductsCount: number;
+    issues: GoogleMerchantProductIssue[];
+    issuesCount: number;
+    lastError?: Omit<NormalizedGoogleMerchantError, "status">;
+    latencyMs: number;
+    productsCount: number;
+};
+export type NormalizedGoogleMerchantError = {
+    code: string;
+    message: string;
+    retryable: boolean;
+    status: GoogleMerchantConnectionStatus;
+};
 type SettingEntry = {
     key: string;
     value: string;
 };
+export declare function normalizeGoogleMerchantError(error: unknown): NormalizedGoogleMerchantError;
 export declare function parseGoogleCredentials(rawCredentials: string): GoogleMerchantCredentials;
 export declare function normalizeMerchantId(rawMerchantId: string): string;
 export declare function normalizeDataSource(rawDataSource: string, merchantId: string): string;
 export declare function parseGoogleMerchantSettings(entries: readonly SettingEntry[]): GoogleMerchantSettings;
 export declare function createGoogleMerchantClients(credentials: GoogleMerchantCredentials): GoogleMerchantClients;
-export declare function buildGoogleProductIdentifier(offerId: string): string;
-export declare function buildGoogleProductName(accountId: string, offerId: string): string;
-export declare function buildGoogleProductInputName(accountId: string, offerId: string): string;
-export declare function toGoogleProductInput(product: GoogleProduct, brand: string): GoogleProductInput;
+export declare function buildGoogleProductIdentifier(offerId: string, contentLanguage?: string, feedLabel?: string): string;
+export declare function buildGoogleProductName(accountId: string, offerId: string, contentLanguage?: string, feedLabel?: string): string;
+export declare function buildGoogleProductInputName(accountId: string, offerId: string, contentLanguage?: string, feedLabel?: string): string;
+export declare function toGoogleProductInput(product: GoogleProduct, brand: string, contentLanguage?: string, feedLabel?: string): GoogleProductInput;
+export declare function validateGoogleProductUrls(product: GoogleProduct): void;
 export declare function buildGoogleUpdateMask(productInput: GoogleProductInput): protos.google.protobuf.IFieldMask;
 export declare function createGoogleInsertOperation(product: GoogleProduct, settings: GoogleMerchantSettings): GoogleWriteOperation;
 export declare function createGoogleUpdateOperation(product: GoogleProduct, settings: GoogleMerchantSettings): GoogleWriteOperation;
 export declare function createGoogleDeleteOperation(communicateID: string, settings: GoogleMerchantSettings): GoogleWriteOperation;
-export declare function runBoundedMerchantOperations<T>(items: readonly T[], operation: (item: T, index: number) => Promise<void>, concurrency?: number): Promise<Array<MerchantOperationResult<T>>>;
-export declare function executeGoogleWriteOperations(client: GoogleProductInputsWriter, operations: readonly GoogleWriteOperation[], concurrency?: number): Promise<Array<MerchantOperationResult<GoogleWriteOperation>>>;
+export declare function runBoundedMerchantOperations<T>(items: readonly T[], operation: (item: T, index: number) => Promise<number | void>, concurrency?: number): Promise<Array<MerchantOperationResult<T>>>;
+export declare function executeGoogleWriteOperations(client: GoogleProductInputsWriter, operations: readonly GoogleWriteOperation[], concurrency?: number, retryOptions?: GoogleMerchantRetryOptions): Promise<Array<MerchantOperationResult<GoogleWriteOperation>>>;
 export declare function summarizeMerchantOperations<T>(results: Array<MerchantOperationResult<T>>): MerchantOperationSummary<T>;
 export declare function collectGoogleProductsForDataSource(client: GoogleProductsReader, accountId: string, dataSource: string): Promise<RemoteProduct[]>;
+export declare function diagnoseGoogleMerchantConnection(client: GoogleProductsReader, settings: Pick<GoogleMerchantSettings, "accountId" | "dataSource">, dataSourcesClient?: GoogleDataSourcesReader): Promise<GoogleMerchantConnectionDiagnostic>;
 export declare function selectRemoteOrphanProducts(remoteProducts: readonly RemoteProduct[], localProducts: readonly Pick<GoogleProduct, "communicateID">[]): RemoteProduct[];
 export {};