cabloy 5.1.127 → 5.1.128

package/.cabloy-version

@@ -1 +1 @@
-5.1.127
+5.1.128

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 5.1.128
+
+### Features
+
+- Add payment session support.
+- Combine resource name components.
+- Add a PayPal Commerce runbook.
+- Implement the product semantic presentation contract.
+- Complete the PayPal Commerce payment flow.
+
+### Bug Fixes
+
+- Preserve changes when resolving main branch conflicts.
+- Enforce payment provider availability.
+- Harden PayPal Commerce reconciliation.
+
 ## 5.1.127
 
 ### Features

package/cabloy-docs/backend/i18n-guide.md

@@ -127,17 +127,96 @@ declare module 'vona' {
 
 In the VSCode workflow, the `recordlocale` snippet can generate the augmentation skeleton.
 
-## Plural support
+## Formatting locale text
 
-Locale resources can express plural-aware strings through naming conventions such as:
+Locale values use printf-style placeholders. Pass formatting values after the locale key:
 
-- `TestApples_`
-- `TestApples_0`
-- `TestApples_1`
+```typescript
+// en-us.ts
+export default {
+  Apples_: '%d apples',
+  Greeting: '%s has %d apples',
+};
+```
+
+```typescript
+this.scope.locale.Apples_.locale('en-us', 2);
+// 2 apples
+
+this.scope.locale.Greeting.locale('en-us', 'Mike', 2);
+// Mike has 2 apples
+```
+
+Common placeholders include:
+
+- `%s`: string
+- `%d`: number
+- `%i`: integer
+- `%f`: floating-point number
+- `%j`: JSON
+- `%%`: literal percent sign
+
+## Plural and value-specific support
+
+Locale resources can express special messages for exact numeric values through key suffixes:
+
+```typescript
+export default {
+  Apples_: '%d apples',
+  Apples_0: 'no apples',
+  Apples_1: 'one apple',
+};
+```
+
+The suffix selects a special message based on the first formatting argument:
+
+```typescript
+this.scope.locale.Apples_.locale('en-us', 0);
+// no apples
+
+this.scope.locale.Apples_.locale('en-us', 1);
+// one apple
 
-Multiple-parameter variants are also supported through ordinal-aware suffix conventions.
+this.scope.locale.Apples_.locale('en-us', 2);
+// 2 apples
+```
+
+The base key is used when no value-specific key matches. Therefore, it is not necessary to define a special key for every possible number.
+
+For a numeric value that is not the first formatting argument, use this naming convention:
+
+```text
+<baseKey>_<matchedValue>_<argumentIndex>
+```
+
+The argument index is zero-based. For example:
+
+```typescript
+export default {
+  NameApples_: '%s has %d apples',
+  NameApples_0_1: '%s has no apples',
+  NameApples_1_1: '%s has one apple',
+};
+```
+
+Here:
+
+- `NameApples_0_1` matches `args[1] === 0`, the second formatting argument;
+- `NameApples_1_1` matches `args[1] === 1`, the second formatting argument;
+- `NameApples_` is used for other values.
+
+```typescript
+this.scope.locale.NameApples_.locale('en-us', 'Mike', 0);
+// Mike has no apples
+
+this.scope.locale.NameApples_.locale('en-us', 'Mike', 1);
+// Mike has one apple
+
+this.scope.locale.NameApples_.locale('en-us', 'Mike', 2);
+// Mike has 2 apples
+```
 
-This makes plural handling part of the localization model instead of forcing each project to invent its own formatting layer.
+This is exact numeric-value selection, not automatic `Intl.PluralRules` or CLDR plural-category resolution. It makes common plural handling part of the localization model while allowing each locale to define its own wording.
 
 ## Timezone support
 

package/e2e/specs/a-commerce/commerce.spec.ts

@@ -415,7 +415,7 @@ test(
       const startResponse = waitForApiResponse(
         page,
         'POST',
-        new RegExp(`/api/payment-session/${checkout.paymentSessionId}/start$`),
+        new RegExp(`/api/pay/payment-session/${checkout.paymentSessionId}/start$`),
       );
       await page.getByRole('button', { name: 'Start payment', exact: true }).click();
       expect((await startResponse).ok()).toBeTruthy();
@@ -535,9 +535,7 @@ test(
       await orderCard.getByRole('button', { name: 'View', exact: true }).click();
       await expect(page).toHaveURL(new RegExp(`/commerce/order/${checkout.orderId}(?:/|$)`));
       await historyDetailResponse;
-      await expect(
-        page.getByRole('heading', { name: `Order #${checkout.orderId}`, level: 1 }),
-      ).toBeVisible();
+      await expect(page.getByRole('heading', { name: `Order #${checkout.orderId}` })).toBeVisible();
       await expect(page.getByText('1 × $45.99 = $45.99')).toBeVisible();
       await expect(page.getByRole('alert')).toHaveCount(0);
       expect(pageErrors).toEqual([]);
@@ -586,7 +584,7 @@ test(
       const startResponse = waitForApiResponse(
         page,
         'POST',
-        new RegExp(`/api/payment-session/${checkout.paymentSessionId}/start$`),
+        new RegExp(`/api/pay/payment-session/${checkout.paymentSessionId}/start$`),
       );
       await page.getByRole('button', { name: 'Start payment', exact: true }).click();
       expect((await startResponse).ok()).toBeTruthy();
@@ -654,7 +652,7 @@ test(
       const startResponse = waitForApiResponse(
         page,
         'POST',
-        new RegExp(`/api/payment-session/${checkout.paymentSessionId}/start$`),
+        new RegExp(`/api/pay/payment-session/${checkout.paymentSessionId}/start$`),
       );
       await page.getByRole('button', { name: 'Start payment', exact: true }).click();
       expect((await startResponse).ok()).toBeTruthy();
@@ -738,8 +736,7 @@ test(
             { timeout: 40_000 },
           )
           .toContain('refunded');
-        const refundedOrderRow = await getAdminOrderRow(adminPage, checkout.orderId);
-        await expect(refundedOrderRow).toContainText('refunded');
+        await expect(await getAdminOrderRow(adminPage, checkout.orderId)).toContainText('refunded');
         expect(adminPageErrors).toEqual([]);
       } finally {
         await adminContext.close().catch(() => {});
@@ -1016,6 +1013,94 @@ test(
   },
 );
 
+test(
+  'ATP-SPC-02: Product renders semantic Admin relation and publication controls',
+  { tag: ['@admin', '@flow', '@product'] },
+  async ({ browser }, testInfo) => {
+    test.setTimeout(60_000);
+    const suffix = `${testInfo.workerIndex}-${testInfo.parallelIndex ?? testInfo.retry}-${Date.now()}`;
+    const categoryName = `E2E Product Category ${suffix}`;
+    const productTitle = `E2E Product ${suffix}`;
+    const adminContext = await browser.newContext();
+    const adminPage = await adminContext.newPage();
+    const adminPageErrors = collectPageErrors(adminPage);
+    const productCreatePath = '/commerce-admin/rest/resource/commerce-catalog%3Aproduct/create';
+    const productListPath = '/commerce-admin/rest/resource/commerce-catalog%3Aproduct';
+    const categoryActionPath = '/api/commerce/catalog/category';
+    const productActionPath = '/api/commerce/catalog/product';
+    let categoryId: number | string | undefined;
+    let productId: number | string | undefined;
+    let headers: { Authorization: string } | undefined;
+    try {
+      await adminPage.setViewportSize({ width: 1440, height: 900 });
+      await login(adminPage, '/commerce-admin/', 'admin', '123456', 'commerceAdmin');
+      const accessToken = (await adminContext.cookies()).find(
+        cookie => cookie.name === 'token',
+      )?.value;
+      expect(accessToken).toBeTruthy();
+      headers = { Authorization: `Bearer ${accessToken}` };
+
+      const categoryResponse = await adminPage.request.post(categoryActionPath, {
+        data: { name: categoryName, published: true },
+        headers,
+      });
+      expect(categoryResponse.ok()).toBeTruthy();
+      categoryId = (await categoryResponse.json()).data;
+      expectTableIdentity(categoryId);
+
+      await adminPage.goto(productCreatePath, { waitUntil: 'load' });
+      const categoryPicker = adminPage
+        .getByRole('group', { name: 'Category' })
+        .getByRole('combobox');
+      await expect(categoryPicker).toBeVisible();
+      await categoryPicker.selectOption({ label: categoryName });
+      await expect(categoryPicker).toHaveValue(String(categoryId));
+      const publication = adminPage.getByRole('group', { name: 'Published' }).getByRole('combobox');
+      await expect(publication).toBeVisible();
+      await publication.selectOption({ label: 'Unpublished' });
+      await expect(publication).toHaveValue('false');
+
+      const productResponse = await adminPage.request.post(productActionPath, {
+        data: { categoryId, title: productTitle, published: false },
+        headers,
+      });
+      expect(productResponse.ok()).toBeTruthy();
+      productId = (await productResponse.json()).data;
+      expectTableIdentity(productId);
+
+      await adminPage.goto(productListPath, { waitUntil: 'load' });
+      const productRow = adminPage.getByRole('row', { name: new RegExp(productTitle) });
+      await expect(productRow).toBeVisible();
+      await expect(productRow.getByText(categoryName, { exact: true })).toBeVisible();
+      await expect(productRow.getByText('Unpublished', { exact: true })).toBeVisible();
+
+      await adminPage.goto(`${productListPath}/${productId}`, { waitUntil: 'load' });
+      await expect(
+        adminPage.getByRole('group', { name: 'Category' }).getByRole('textbox'),
+      ).toHaveValue(categoryName);
+      await expect(
+        adminPage.getByRole('group', { name: 'Published' }).getByRole('textbox'),
+      ).toHaveValue('Unpublished');
+      await expect(adminPage.getByRole('button', { name: 'Submit', exact: true })).toHaveCount(0);
+      expect(adminPageErrors).toEqual([]);
+    } finally {
+      if (productId && headers) {
+        const response = await adminPage.request.delete(`${productActionPath}/${productId}`, {
+          headers,
+        });
+        expect(response.ok()).toBeTruthy();
+      }
+      if (categoryId && headers) {
+        const response = await adminPage.request.delete(`${categoryActionPath}/${categoryId}`, {
+          headers,
+        });
+        expect(response.ok()).toBeTruthy();
+      }
+      await adminContext.close().catch(() => {});
+    }
+  },
+);
+
 test(
   'Commerce Cart: anonymous browser is redirected to login',
   { tag: ['@web', '@cart'] },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cabloy",
-  "version": "5.1.127",
+  "version": "5.1.128",
   "gitHead": "2c5c19284bab738e492856189acb6fad74b8a7b7",
   "description": "A Node.js fullstack framework",
   "keywords": [

package/vona/env/.env

@@ -91,6 +91,8 @@ PAY_MOCK_SECONDARY_WEBHOOK = pay-mock-dev-secondary-webhook
 PAYPAL_CLIENT_ID =
 PAYPAL_CLIENT_SECRET =
 PAYPAL_WEBHOOK_ID =
+PAYPAL_MERCHANT_REFERENCE =
+PAYPAL_ENVIRONMENT = sandbox
 STRIPE_SECRET_KEY =
 STRIPE_WEBHOOK_SECRET =
 

package/vona/env/.env.prod

@@ -24,5 +24,9 @@ DATABASE_CLIENT_MYSQL_DATABASE = xxx
 
 REDIS_DEFAULT_HOST = 127.0.0.1
 REDIS_DEFAULT_PORT = 6379
-REDIS_DEFAULT_PASSWORD = 
-REDIS_DEFAULT_DB = 0
+REDIS_DEFAULT_PASSWORD =
+REDIS_DEFAULT_DB = 0
+
+# payment
+
+PAYPAL_ENVIRONMENT = live

package/vona/packages-cli/cabloy-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cabloy/cli",
-  "version": "3.1.28",
+  "version": "3.1.29",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "@cabloy/cli",
   "keywords": [

package/vona/packages-cli/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-cli",
-  "version": "1.1.137",
+  "version": "1.1.138",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "vona cli",
   "keywords": [

package/vona/packages-cli/cli-set-api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-cli-set-api",
-  "version": "1.1.135",
+  "version": "1.1.136",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "vona cli-set-api",
   "keywords": [

package/vona/packages-utils/module-glob/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cabloy/module-glob",
-  "version": "5.3.17",
+  "version": "5.3.18",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "cabloy module-glob",
   "keywords": [

package/vona/packages-utils/utils/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cabloy/utils",
-  "version": "2.1.26",
+  "version": "2.1.27",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "cabloy utils",
   "keywords": [

package/vona/packages-utils/utils/src/vona.ts

@@ -17,7 +17,14 @@ export function combineResourceNameParts(
   // path
   const res: string[] = [];
   if (!simplifyProviderId || parts[0] !== 'a') res.push(parts[0]);
-  if (!simplify || !resourceName.startsWith(parts[1])) res.push(parts[1]);
+  if (
+    !simplify ||
+    (resourceName !== parts[1] &&
+      !resourceName.startsWith(`${parts[1]}-`) &&
+      !resourceName.startsWith(`${parts[1]}/`))
+  ) {
+    res.push(parts[1]);
+  }
   if (resourceName) res.push(resourceName);
   return res;
 }

package/vona/packages-vona/vona/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona",
-  "version": "5.1.84",
+  "version": "5.1.85",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "Vona is an intuitive, elegant and powerful Node.js framework for rapidly developing enterprise applications of any size",
   "keywords": [

package/vona/packages-vona/vona-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-core",
-  "version": "5.1.36",
+  "version": "5.1.37",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "vona",
   "keywords": [

package/vona/packages-vona/vona-mock/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vona-mock",
-  "version": "6.1.36",
+  "version": "6.1.37",
   "gitHead": "a79189b882c17af5911573896a781bbb0046d37d",
   "description": "vona mock",
   "keywords": [

package/vona/pnpm-lock.yaml

@@ -24,7 +24,7 @@ importers:
     dependencies:
       '@babel/core':
         specifier: ^7.29.0
-        version: 7.29.7(supports-color@5.5.0)
+        version: 7.29.7
       '@babel/traverse':
         specifier: ^7.29.0
         version: 7.29.7
@@ -69,7 +69,7 @@ importers:
         version: 8.0.1
       bullmq:
         specifier: ^5.74.1
-        version: 5.79.1(supports-color@5.5.0)
+        version: 5.79.1
       chalk:
         specifier: ^5.6.2
         version: 5.6.2
@@ -81,7 +81,7 @@ importers:
         version: 11.3.5
       ioredis:
         specifier: ^5.10.1
-        version: 5.11.1(supports-color@5.5.0)
+        version: 5.11.1
       knex:
         specifier: ^3.3.0
         version: 3.3.0(better-sqlite3@12.11.1)
@@ -2756,7 +2756,7 @@ importers:
     dependencies:
       bullmq:
         specifier: ^5.74.1
-        version: 5.79.1(supports-color@5.5.0)
+        version: 5.79.1
     devDependencies:
       clean-package:
         specifier: ^2.2.0
@@ -2778,7 +2778,7 @@ importers:
     dependencies:
       ioredis:
         specifier: ^5.10.1
-        version: 5.11.1(supports-color@5.5.0)
+        version: 5.11.1
     devDependencies:
       clean-package:
         specifier: ^2.2.0
@@ -8962,26 +8962,6 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/core@7.29.7(supports-color@5.5.0)':
-    dependencies:
-      '@babel/code-frame': 7.29.7
-      '@babel/generator': 7.29.7
-      '@babel/helper-compilation-targets': 7.29.7
-      '@babel/helper-module-transforms': 7.29.7(@babel/core@7.29.7(supports-color@5.5.0))
-      '@babel/helpers': 7.29.7
-      '@babel/parser': 7.29.7
-      '@babel/template': 7.29.7
-      '@babel/traverse': 7.29.7
-      '@babel/types': 7.29.7
-      '@jridgewell/remapping': 2.3.5
-      convert-source-map: 2.0.0
-      debug: 4.4.3(supports-color@5.5.0)
-      gensync: 1.0.0-beta.2
-      json5: 2.2.3
-      semver: 6.3.1
-    transitivePeerDependencies:
-      - supports-color
-
   '@babel/generator@7.29.7':
     dependencies:
       '@babel/parser': 7.29.7
@@ -9031,15 +9011,6 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  '@babel/helper-module-transforms@7.29.7(@babel/core@7.29.7(supports-color@5.5.0))':
-    dependencies:
-      '@babel/core': 7.29.7(supports-color@5.5.0)
-      '@babel/helper-module-imports': 7.29.7
-      '@babel/helper-validator-identifier': 7.29.7
-      '@babel/traverse': 7.29.7
-    transitivePeerDependencies:
-      - supports-color
-
   '@babel/helper-module-transforms@7.29.7(@babel/core@7.29.7)':
     dependencies:
       '@babel/core': 7.29.7
@@ -10006,7 +9977,7 @@ snapshots:
 
   '@sesamecare-oss/redlock@1.4.0(ioredis@5.11.1)':
     dependencies:
-      ioredis: 5.11.1(supports-color@5.5.0)
+      ioredis: 5.11.1
 
   '@sindresorhus/merge-streams@2.3.0': {}
 
@@ -10912,10 +10883,10 @@ snapshots:
       base64-js: 1.5.1
       ieee754: 1.2.1
 
-  bullmq@5.79.1(supports-color@5.5.0):
+  bullmq@5.79.1:
     dependencies:
       cron-parser: 4.9.0
-      ioredis: 5.10.1(supports-color@5.5.0)
+      ioredis: 5.10.1
       msgpackr: 2.0.2
       node-abort-controller: 3.1.1
       semver: 7.8.1
@@ -12061,7 +12032,7 @@ snapshots:
 
   interpret@2.2.0: {}
 
-  ioredis@5.10.1(supports-color@5.5.0):
+  ioredis@5.10.1:
     dependencies:
       '@ioredis/commands': 1.5.1
       cluster-key-slot: 1.1.2
@@ -12075,7 +12046,7 @@ snapshots:
     transitivePeerDependencies:
       - supports-color
 
-  ioredis@5.11.1(supports-color@5.5.0):
+  ioredis@5.11.1:
     dependencies:
       '@ioredis/commands': 1.10.0
       cluster-key-slot: 1.1.1

package/vona/src/suite/a-commerce/modules/commerce-catalog/src/.metadata/index.ts

@@ -149,7 +149,7 @@ declare module 'vona-module-commerce-catalog' {
       }
 export interface IModelOptionsProduct {
         relations: {
-          category: IModelRelationBelongsTo<'commerce-catalog:product', 'commerce-catalog:category', false, '*'>;
+          category: IModelRelationBelongsTo<'commerce-catalog:product', 'commerce-catalog:category', false, 'id'|'name'|'published'>;
 skus: IModelRelationHasMany<'commerce-catalog:sku', 'productId', false, '*', undefined, undefined, undefined>;
 skuAvailables: IModelRelationHasMany<'commerce-catalog:sku', 'productId', false, 'id'|'code'|'productId'|'priceCents', ['commerce-trade:stockBalance'], undefined, undefined>;
         };

package/vona/src/suite/a-commerce/modules/commerce-catalog/src/dto/productSelectResItem.tsx

@@ -46,7 +46,9 @@ export interface IDtoOptionsProductSelectResItem extends IDecoratorDtoOptions {}
     }),
   ],
 })
-export class DtoProductSelectResItem extends $Dto.get(() => ModelProduct) {
+export class DtoProductSelectResItem extends $Dto.get(() => ModelProduct, {
+  include: { category: true },
+}) {
   @Api.field(
     v.title($locale('Operations')),
     ZovaRender.order(1, 'max'),

package/vona/src/suite/a-commerce/modules/commerce-catalog/src/dto/productView.tsx

@@ -22,4 +22,6 @@ export interface IDtoOptionsProductView extends IDecoratorDtoOptions {}
     }),
   ],
 })
-export class DtoProductView extends $Dto.get(() => ModelProduct) {}
+export class DtoProductView extends $Dto.get(() => ModelProduct, {
+  include: { category: true },
+}) {}

package/vona/src/suite/a-commerce/modules/commerce-catalog/src/entity/product.tsx

@@ -1,11 +1,12 @@
 import type { TableIdentity } from 'table-identity';
 import type { IDecoratorEntityOptions } from 'vona-module-a-orm';
 
-import { $makeMetadata, Api, v } from 'vona-module-a-openapiutils';
+import { $makeMetadata, $resourceName, Api, v } from 'vona-module-a-openapiutils';
 import { Entity, EntityBase } from 'vona-module-a-orm';
 import { ZovaRender } from 'zova-rest-cabloy-basic-admin';
 
 import { $locale } from '../.metadata/locales.ts';
+import { categoryPublicationItems } from './category.tsx';
 
 export interface IEntityOptionsProduct extends IDecoratorEntityOptions {}
 
@@ -37,10 +38,29 @@ export class EntityProduct extends EntityBase {
   )
   title: string;
 
-  @Api.field(v.title($locale('Category')), v.required(), ZovaRender.order(2), v.tableIdentity())
+  @Api.field(
+    v.title($locale('Category')),
+    v.required(),
+    ZovaRender.order(2),
+    ZovaRender.field('basic-resource:formFieldResourcePicker', {
+      resource: $resourceName('commerce-catalog:category'),
+      relationName: 'category',
+    }),
+    ZovaRender.cell('basic-resource:resourcePicker', {
+      resource: $resourceName('commerce-catalog:category'),
+      relationName: 'category',
+    }),
+    v.tableIdentity(),
+  )
   categoryId: TableIdentity;
 
-  @Api.field(v.title($locale('Published')), v.default(false), ZovaRender.order(3))
+  @Api.field(
+    v.title($locale('Published')),
+    v.default(false),
+    ZovaRender.order(3),
+    ZovaRender.field('basic-select:formFieldSelect', { items: categoryPublicationItems }),
+    ZovaRender.cell('basic-select:select', { items: categoryPublicationItems }),
+  )
   published: boolean;
 
   @Api.field(v.title($locale('Description')), v.optional(), ZovaRender.order(4))

package/vona/src/suite/a-commerce/modules/commerce-catalog/src/model/product.ts

@@ -13,6 +13,7 @@ export interface IModelOptionsProduct extends IDecoratorModelOptions<EntityProdu
       'commerce-catalog:product',
       'commerce-catalog:category',
       'categoryId',
+      { columns: ['id', 'name', 'published'] },
     ),
     skus: $relation.hasMany('commerce-catalog:sku', 'productId'),
     skuAvailables: $relation.hasMany(

package/vona/src/suite/a-commerce/modules/commerce-catalog/src/service/product.ts

@@ -22,7 +22,10 @@ export class ServiceProduct extends BeanBase {
   }
 
   async select(params?: IQueryParams<ModelProduct>): Promise<DtoProductSelectRes> {
-    return await this.scope.model.product.selectAndCount(params);
+    return await this.scope.model.product.selectAndCount({
+      ...params,
+      include: { ...params?.include, category: true },
+    });
   }
 
   async selectPublic(params: IQueryParams<ModelProduct>): Promise<DtoProductPublicSelectRes> {
@@ -50,7 +53,9 @@ export class ServiceProduct extends BeanBase {
   }
 
   async view(id: TableIdentity): Promise<DtoProductView | undefined> {
-    return await this.scope.model.product.getById(id);
+    return await this.scope.model.product.getById(id, {
+      include: { category: true },
+    });
   }
 
   async viewPublic(id: TableIdentity): Promise<DtoProductPublic | undefined> {