@fiado/api-invoker 5.30.0 → 5.31.0

package/bin/membership/MembershipApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { IMembershipApi } from "./interfaces/IMembershipApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export declare class MembershipApi implements IMembershipApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/membership/MembershipApi.js

@@ -0,0 +1,32 @@
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+import dotenv from 'dotenv';
+dotenv.config();
+let MembershipApi = class MembershipApi {
+    httpRequest;
+    baseUrl = process.env.MEMBERSHIP_BUSINESS_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async deleteByDirectoryId(directoryId) {
+        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        return await this.httpRequest.delete(url);
+    }
+};
+MembershipApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], MembershipApi);
+export { MembershipApi };

package/bin/membership/index.d.ts

@@ -0,0 +1,2 @@
+export * from './interfaces/IMembershipApi.js';
+export * from './MembershipApi.js';

package/bin/membership/index.js

@@ -0,0 +1,2 @@
+export * from './interfaces/IMembershipApi.js';
+export * from './MembershipApi.js';

package/bin/membership/interfaces/IMembershipApi.d.ts

@@ -0,0 +1,15 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Interfaz para el servicio Membership (membership-business).
+ */
+export interface IMembershipApi {
+    /**
+     * Borra en cascada las membresías asociadas a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/membership/interfaces/IMembershipApi.js

@@ -0,0 +1 @@
+export {};

package/bin/notificationWebsockets/NotificationWebsocketApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { INotificationWebsocketApi } from "./interfaces/INotificationWebsocketApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export declare class NotificationWebsocketApi implements INotificationWebsocketApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/notificationWebsockets/NotificationWebsocketApi.js

@@ -0,0 +1,32 @@
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+import dotenv from 'dotenv';
+dotenv.config();
+let NotificationWebsocketApi = class NotificationWebsocketApi {
+    httpRequest;
+    baseUrl = process.env.NOTIFICATIONS_WEBSOCKET_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async deleteByDirectoryId(directoryId) {
+        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        return await this.httpRequest.delete(url);
+    }
+};
+NotificationWebsocketApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], NotificationWebsocketApi);
+export { NotificationWebsocketApi };

package/bin/notificationWebsockets/interfaces/INotificationWebsocketApi.d.ts

@@ -0,0 +1,15 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Interfaz para el servicio Notifications Websocket (notifications-websocket).
+ */
+export interface INotificationWebsocketApi {
+    /**
+     * Borra en cascada las conexiones/notificaciones WS asociadas a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/notificationWebsockets/interfaces/INotificationWebsocketApi.js

@@ -0,0 +1 @@
+export {};

package/bin/performance-profile/PerformanceProfileApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { IPerformanceProfileApi } from "./interfaces/IPerformanceProfileApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export declare class PerformanceProfileApi implements IPerformanceProfileApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/performance-profile/PerformanceProfileApi.js

@@ -0,0 +1,32 @@
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+import dotenv from 'dotenv';
+dotenv.config();
+let PerformanceProfileApi = class PerformanceProfileApi {
+    httpRequest;
+    baseUrl = process.env.PERFORMANCE_PROFILE_BUSINESS_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async deleteByDirectoryId(directoryId) {
+        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        return await this.httpRequest.delete(url);
+    }
+};
+PerformanceProfileApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], PerformanceProfileApi);
+export { PerformanceProfileApi };

package/bin/performance-profile/index.d.ts

@@ -0,0 +1,2 @@
+export * from './interfaces/IPerformanceProfileApi.js';
+export * from './PerformanceProfileApi.js';

package/bin/performance-profile/index.js

@@ -0,0 +1,2 @@
+export * from './interfaces/IPerformanceProfileApi.js';
+export * from './PerformanceProfileApi.js';

package/bin/performance-profile/interfaces/IPerformanceProfileApi.d.ts

@@ -0,0 +1,15 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Interfaz para el servicio Performance Profile (performance-profile-business).
+ */
+export interface IPerformanceProfileApi {
+    /**
+     * Borra en cascada los perfiles de desempeño asociados a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/performance-profile/interfaces/IPerformanceProfileApi.js

@@ -0,0 +1 @@
+export {};

package/bin/presence-websocket/PresenceWebsocketApi.d.ts

@@ -0,0 +1,12 @@
+import { IHttpRequest } from "@fiado/http-client";
+import { IPresenceWebsocketApi } from "./interfaces/IPresenceWebsocketApi.js";
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+export declare class PresenceWebsocketApi implements IPresenceWebsocketApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/presence-websocket/PresenceWebsocketApi.js

@@ -0,0 +1,32 @@
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+import dotenv from 'dotenv';
+dotenv.config();
+let PresenceWebsocketApi = class PresenceWebsocketApi {
+    httpRequest;
+    baseUrl = process.env.PRESENCE_WEBSOCKET_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async deleteByDirectoryId(directoryId) {
+        const url = `${this.baseUrl}private/directory/${directoryId}`;
+        return await this.httpRequest.delete(url);
+    }
+};
+PresenceWebsocketApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], PresenceWebsocketApi);
+export { PresenceWebsocketApi };

package/bin/presence-websocket/index.d.ts

@@ -0,0 +1,2 @@
+export * from './interfaces/IPresenceWebsocketApi.js';
+export * from './PresenceWebsocketApi.js';

package/bin/presence-websocket/index.js

@@ -0,0 +1,2 @@
+export * from './interfaces/IPresenceWebsocketApi.js';
+export * from './PresenceWebsocketApi.js';

package/bin/presence-websocket/interfaces/IPresenceWebsocketApi.d.ts

@@ -0,0 +1,15 @@
+type FiadoApiResponse<T> = import("@fiado/type-kit/bin/apiResponse/dtos/FiadoApiResponse.js").default<T>;
+/**
+ * Interfaz para el servicio Presence Websocket (presence-websocket).
+ */
+export interface IPresenceWebsocketApi {
+    /**
+     * Borra en cascada los registros de presencia asociados a un directoryId.
+     * @param directoryId ID del directorio.
+     * @throws {Error} Lanza un error si los parámetros de entrada son inválidos.
+     */
+    deleteByDirectoryId(directoryId: string): Promise<FiadoApiResponse<{
+        deletedCount: number;
+    }>>;
+}
+export {};

package/bin/presence-websocket/interfaces/IPresenceWebsocketApi.js

@@ -0,0 +1 @@
+export {};

package/bin/retailCards/api/RetailCardsBusinessApi.d.ts

@@ -1,11 +1,11 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { AssignCardRequest } from "@fiado/type-kit/bin/retailCards/index.js";
-import { IRetailCardsBusinessApi, MarkDeliveredBody, ReleaseCardBody } from "./interfaces/IRetailCardsBusinessApi.js";
+import { CardDeliveryResponse, RegisterCardDeliveryRequest, ReverseCardMovementRequest } from "@fiado/type-kit/bin/retailCards/index.js";
+import { IRetailCardsBusinessApi } from "./interfaces/IRetailCardsBusinessApi.js";
 /**
  * Publisher HTTP del lambda `retail-cards-business` (SureKeep Fase 1, pista Retail) para sus endpoints
- * privados de la tarjeta física PCF. Contrato y semántica completos → `IRetailCardsBusinessApi`
- * (tenant por `?tenantId=` canónico, `StandardResponse` → leer `result.data`).
+ * privados del inventario de tarjetas físicas PCF. Contrato y semántica completos →
+ * `IRetailCardsBusinessApi` (tenant por `?tenantId=` canónico, `StandardResponse` → leer `result.data`).
  *
  * Env var requerida en el consumer: `RETAIL_CARDS_BUSINESS_URL`.
  * El template.yml del consumer la setea con:
@@ -18,7 +18,6 @@ export default class RetailCardsBusinessApi implements IRetailCardsBusinessApi {
     private httpRequest;
     private readonly baseUrl;
     constructor(httpRequest: IHttpRequest);
-    assign(cardNumber: string, body: AssignCardRequest, tenantId: string): Promise<StandardResponse<void>>;
-    markDelivered(cardNumber: string, body: MarkDeliveredBody, tenantId: string): Promise<StandardResponse<void>>;
-    release(cardNumber: string, body: ReleaseCardBody, tenantId: string): Promise<StandardResponse<void>>;
+    registerDelivery(storeId: string, body: RegisterCardDeliveryRequest, tenantId: string): Promise<StandardResponse<CardDeliveryResponse>>;
+    reverseDelivery(storeId: string, body: ReverseCardMovementRequest, tenantId: string): Promise<StandardResponse<void>>;
 }

package/bin/retailCards/api/RetailCardsBusinessApi.js

@@ -13,8 +13,8 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 import { inject, injectable } from "inversify";
 /**
  * Publisher HTTP del lambda `retail-cards-business` (SureKeep Fase 1, pista Retail) para sus endpoints
- * privados de la tarjeta física PCF. Contrato y semántica completos → `IRetailCardsBusinessApi`
- * (tenant por `?tenantId=` canónico, `StandardResponse` → leer `result.data`).
+ * privados del inventario de tarjetas físicas PCF. Contrato y semántica completos →
+ * `IRetailCardsBusinessApi` (tenant por `?tenantId=` canónico, `StandardResponse` → leer `result.data`).
  *
  * Env var requerida en el consumer: `RETAIL_CARDS_BUSINESS_URL`.
  * El template.yml del consumer la setea con:
@@ -30,16 +30,12 @@ let RetailCardsBusinessApi = class RetailCardsBusinessApi {
     constructor(httpRequest) {
         this.httpRequest = httpRequest;
     }
-    async assign(cardNumber, body, tenantId) {
-        const url = `${this.baseUrl}/private/cards/${encodeURIComponent(cardNumber)}/assign?tenantId=${encodeURIComponent(tenantId)}`;
+    async registerDelivery(storeId, body, tenantId) {
+        const url = `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/card-deliveries?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, body);
     }
-    async markDelivered(cardNumber, body, tenantId) {
-        const url = `${this.baseUrl}/private/cards/${encodeURIComponent(cardNumber)}/deliver?tenantId=${encodeURIComponent(tenantId)}`;
-        return await this.httpRequest.post(url, body);
-    }
-    async release(cardNumber, body, tenantId) {
-        const url = `${this.baseUrl}/private/cards/${encodeURIComponent(cardNumber)}/release?tenantId=${encodeURIComponent(tenantId)}`;
+    async reverseDelivery(storeId, body, tenantId) {
+        const url = `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/card-movements/reverse?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, body);
     }
 };

package/bin/retailCards/api/interfaces/IRetailCardsBusinessApi.d.ts

@@ -1,8 +1,8 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { AssignCardRequest } from "@fiado/type-kit/bin/retailCards/index.js";
+import { CardDeliveryResponse, RegisterCardDeliveryRequest, ReverseCardMovementRequest } from "@fiado/type-kit/bin/retailCards/index.js";
 /**
  * Contrato del publisher HTTP del lambda `retail-cards-business` (SureKeep Fase 1, pista Retail) para
- * sus endpoints privados de la tarjeta física PCF, consumidos por el wizard F2 (paso 09, spike S7).
+ * sus endpoints privados del inventario de tarjetas físicas PCF, consumidos por el wizard F2 (paso 09).
  *
  * ─────────────────────────────────────────────────────────────────────────────
  * TENANT — `?tenantId=` CANÓNICO (query), NO header `x-tenant-issuer`.
@@ -14,28 +14,24 @@ import { AssignCardRequest } from "@fiado/type-kit/bin/retailCards/index.js";
  * ⚠️ Retorno `StandardResponse<T>` — el consumer lee `result.data`, NO `result.body`.
  * Errores: el destino lanza `DomainError` tipado → el publisher RECHAZA (no devuelve null).
  *
- * `deliver`/`release` reciben un body ligero (`{ deliveredByUserId? }` / `{ releasedByUserId? }`) que el
- * destino no publica como DTO en `@fiado/type-kit` → se declara INLINE aquí. `assign` sí usa el DTO
- * `AssignCardRequest` del type-kit (`{ assignedToCustomerId, assignedByUserId, creditId? }`).
+ * El inventario se lleva por CANTIDAD: no hay número de tarjeta en ningún path ni body. El `storeId`
+ * viaja en el path y el destino valida que la tienda pertenezca al retailer del caller.
  *
  * Env var requerida en el consumer: `RETAIL_CARDS_BUSINESS_URL`.
  * El template.yml del consumer la setea con:
  *
  *   RETAIL_CARDS_BUSINESS_URL: '{{resolve:ssm:retail-cards-business}}'
  */
-/** Body de POST `/private/cards/{cardNumber}/deliver`. */
-export interface MarkDeliveredBody {
-    deliveredByUserId?: string;
-}
-/** Body de POST `/private/cards/{cardNumber}/release`. */
-export interface ReleaseCardBody {
-    releasedByUserId?: string;
-}
 export interface IRetailCardsBusinessApi {
-    /** POST `/private/cards/{cardNumber}/assign` — asigna la tarjeta física a un cliente (paso 09). */
-    assign(cardNumber: string, body: AssignCardRequest, tenantId: string): Promise<StandardResponse<void>>;
-    /** POST `/private/cards/{cardNumber}/deliver` — marca la tarjeta como entregada al cliente (D8). */
-    markDelivered(cardNumber: string, body: MarkDeliveredBody, tenantId: string): Promise<StandardResponse<void>>;
-    /** POST `/private/cards/{cardNumber}/release` — revierte la asignación si la venta se cancela (DEC-007 destino). */
-    release(cardNumber: string, body: ReleaseCardBody, tenantId: string): Promise<StandardResponse<void>>;
+    /**
+     * POST `/private/stores/{storeId}/card-deliveries` — entrega una tarjeta física a un cliente
+     * (paso 09): descuenta el saldo y asienta el movimiento en una sola operación. Idempotente por
+     * `sessionId` — el reintento devuelve el `deliveryId` original con 200.
+     */
+    registerDelivery(storeId: string, body: RegisterCardDeliveryRequest, tenantId: string): Promise<StandardResponse<CardDeliveryResponse>>;
+    /**
+     * POST `/private/stores/{storeId}/card-movements/reverse` — revierte un asiento si la venta se
+     * cancela (DEC-007 destino). Escribe un contraasiento, no borra el original.
+     */
+    reverseDelivery(storeId: string, body: ReverseCardMovementRequest, tenantId: string): Promise<StandardResponse<void>>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.30.0",
+  "version": "5.31.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "type": "module",
   "main": "bin/index.js",
@@ -34,7 +34,7 @@
     "@fiado/gateway-adapter": "^3.9.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.309.0",
+    "@fiado/type-kit": "^3.311.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/retailCards/api/RetailCardsBusinessApi.ts

@@ -1,17 +1,17 @@
 import { inject, injectable } from "inversify";
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { AssignCardRequest } from "@fiado/type-kit/bin/retailCards/index.js";
 import {
-    IRetailCardsBusinessApi,
-    MarkDeliveredBody,
-    ReleaseCardBody,
-} from "./interfaces/IRetailCardsBusinessApi.js";
+    CardDeliveryResponse,
+    RegisterCardDeliveryRequest,
+    ReverseCardMovementRequest,
+} from "@fiado/type-kit/bin/retailCards/index.js";
+import { IRetailCardsBusinessApi } from "./interfaces/IRetailCardsBusinessApi.js";
 
 /**
  * Publisher HTTP del lambda `retail-cards-business` (SureKeep Fase 1, pista Retail) para sus endpoints
- * privados de la tarjeta física PCF. Contrato y semántica completos → `IRetailCardsBusinessApi`
- * (tenant por `?tenantId=` canónico, `StandardResponse` → leer `result.data`).
+ * privados del inventario de tarjetas físicas PCF. Contrato y semántica completos →
+ * `IRetailCardsBusinessApi` (tenant por `?tenantId=` canónico, `StandardResponse` → leer `result.data`).
  *
  * Env var requerida en el consumer: `RETAIL_CARDS_BUSINESS_URL`.
  * El template.yml del consumer la setea con:
@@ -27,18 +27,21 @@ export default class RetailCardsBusinessApi implements IRetailCardsBusinessApi {
 
     constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
 
-    async assign(cardNumber: string, body: AssignCardRequest, tenantId: string): Promise<StandardResponse<void>> {
-        const url = `${this.baseUrl}/private/cards/${encodeURIComponent(cardNumber)}/assign?tenantId=${encodeURIComponent(tenantId)}`;
+    async registerDelivery(
+        storeId: string,
+        body: RegisterCardDeliveryRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<CardDeliveryResponse>> {
+        const url = `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/card-deliveries?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, body);
     }
 
-    async markDelivered(cardNumber: string, body: MarkDeliveredBody, tenantId: string): Promise<StandardResponse<void>> {
-        const url = `${this.baseUrl}/private/cards/${encodeURIComponent(cardNumber)}/deliver?tenantId=${encodeURIComponent(tenantId)}`;
-        return await this.httpRequest.post(url, body);
-    }
-
-    async release(cardNumber: string, body: ReleaseCardBody, tenantId: string): Promise<StandardResponse<void>> {
-        const url = `${this.baseUrl}/private/cards/${encodeURIComponent(cardNumber)}/release?tenantId=${encodeURIComponent(tenantId)}`;
+    async reverseDelivery(
+        storeId: string,
+        body: ReverseCardMovementRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<void>> {
+        const url = `${this.baseUrl}/private/stores/${encodeURIComponent(storeId)}/card-movements/reverse?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, body);
     }
 }

package/src/retailCards/api/interfaces/IRetailCardsBusinessApi.ts

@@ -1,9 +1,13 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { AssignCardRequest } from "@fiado/type-kit/bin/retailCards/index.js";
+import {
+    CardDeliveryResponse,
+    RegisterCardDeliveryRequest,
+    ReverseCardMovementRequest,
+} from "@fiado/type-kit/bin/retailCards/index.js";
 
 /**
  * Contrato del publisher HTTP del lambda `retail-cards-business` (SureKeep Fase 1, pista Retail) para
- * sus endpoints privados de la tarjeta física PCF, consumidos por el wizard F2 (paso 09, spike S7).
+ * sus endpoints privados del inventario de tarjetas físicas PCF, consumidos por el wizard F2 (paso 09).
  *
  * ─────────────────────────────────────────────────────────────────────────────
  * TENANT — `?tenantId=` CANÓNICO (query), NO header `x-tenant-issuer`.
@@ -15,33 +19,33 @@ import { AssignCardRequest } from "@fiado/type-kit/bin/retailCards/index.js";
  * ⚠️ Retorno `StandardResponse<T>` — el consumer lee `result.data`, NO `result.body`.
  * Errores: el destino lanza `DomainError` tipado → el publisher RECHAZA (no devuelve null).
  *
- * `deliver`/`release` reciben un body ligero (`{ deliveredByUserId? }` / `{ releasedByUserId? }`) que el
- * destino no publica como DTO en `@fiado/type-kit` → se declara INLINE aquí. `assign` sí usa el DTO
- * `AssignCardRequest` del type-kit (`{ assignedToCustomerId, assignedByUserId, creditId? }`).
+ * El inventario se lleva por CANTIDAD: no hay número de tarjeta en ningún path ni body. El `storeId`
+ * viaja en el path y el destino valida que la tienda pertenezca al retailer del caller.
  *
  * Env var requerida en el consumer: `RETAIL_CARDS_BUSINESS_URL`.
  * El template.yml del consumer la setea con:
  *
  *   RETAIL_CARDS_BUSINESS_URL: '{{resolve:ssm:retail-cards-business}}'
  */
-
-/** Body de POST `/private/cards/{cardNumber}/deliver`. */
-export interface MarkDeliveredBody {
-    deliveredByUserId?: string;
-}
-
-/** Body de POST `/private/cards/{cardNumber}/release`. */
-export interface ReleaseCardBody {
-    releasedByUserId?: string;
-}
-
 export interface IRetailCardsBusinessApi {
-    /** POST `/private/cards/{cardNumber}/assign` — asigna la tarjeta física a un cliente (paso 09). */
-    assign(cardNumber: string, body: AssignCardRequest, tenantId: string): Promise<StandardResponse<void>>;
-
-    /** POST `/private/cards/{cardNumber}/deliver` — marca la tarjeta como entregada al cliente (D8). */
-    markDelivered(cardNumber: string, body: MarkDeliveredBody, tenantId: string): Promise<StandardResponse<void>>;
+    /**
+     * POST `/private/stores/{storeId}/card-deliveries` — entrega una tarjeta física a un cliente
+     * (paso 09): descuenta el saldo y asienta el movimiento en una sola operación. Idempotente por
+     * `sessionId` — el reintento devuelve el `deliveryId` original con 200.
+     */
+    registerDelivery(
+        storeId: string,
+        body: RegisterCardDeliveryRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<CardDeliveryResponse>>;
 
-    /** POST `/private/cards/{cardNumber}/release` — revierte la asignación si la venta se cancela (DEC-007 destino). */
-    release(cardNumber: string, body: ReleaseCardBody, tenantId: string): Promise<StandardResponse<void>>;
+    /**
+     * POST `/private/stores/{storeId}/card-movements/reverse` — revierte un asiento si la venta se
+     * cancela (DEC-007 destino). Escribe un contraasiento, no borra el original.
+     */
+    reverseDelivery(
+        storeId: string,
+        body: ReverseCardMovementRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<void>>;
 }