sinfactura-types 1.10.651 → 1.10.652

package/dist/cjs/socket.js

@@ -583,8 +583,8 @@ exports.SOCKET_ACTIONS = [
     // ⚠️ A frame for a period whose `periodStatus` is `'OPEN'` carries numbers
     // ML will still restate; a consumer must not render one as final.
     'mercadolibre_settlement_period',
-    // BE → all store users when an avanzado custom domain's provisioning state
-    // moves (`CustomDomainSocketPayload`). Status only: the row's
+    // BE → the store's OPERATOR sockets when an avanzado custom domain's provisioning state
+    // moves, or a teardown removes it (`provisioning: null`) (`CustomDomainSocketPayload`). Status only: the row's
     // `verificationToken` is an ownership credential and is never re-sent here.
     'customDomain',
     // BE → all store users on every purchase-order write: create, update, cancel,

package/dist/socket.d.ts

@@ -40,6 +40,12 @@ export interface CustomDomainSocketPayload {
     storeId: string;
     /** The NORMALIZED host, as stored on the row. */
     host: string;
+    /**
+     * The attempt as it now stands, or `null` when a teardown (a deprovision, a
+     * revoke, the grace-expiry sweep) removed it — whatever state it was in.
+     * Merge the `null` over a cached row: the attempt is gone, and the host can
+     * be provisioned again.
+     */
     provisioning: {
         state: DomainProvisioningState;
         /** 1-based; see `DomainProvisioning.step`. */
@@ -55,7 +61,7 @@ export interface CustomDomainSocketPayload {
         /** Unix MILLISECONDS. Present once `state` reaches `active`. */
         activatedAt?: number;
         error?: string;
-    };
+    } | null;
     /**
      * See `DomainRecord.deactivatesAt`. Every frame the server sends carries the
      * key — the number, or `null` when the domain is not in grace — so any frame

package/dist/socket.js

@@ -580,8 +580,8 @@ export const SOCKET_ACTIONS = [
     // ⚠️ A frame for a period whose `periodStatus` is `'OPEN'` carries numbers
     // ML will still restate; a consumer must not render one as final.
     'mercadolibre_settlement_period',
-    // BE → all store users when an avanzado custom domain's provisioning state
-    // moves (`CustomDomainSocketPayload`). Status only: the row's
+    // BE → the store's OPERATOR sockets when an avanzado custom domain's provisioning state
+    // moves, or a teardown removes it (`provisioning: null`) (`CustomDomainSocketPayload`). Status only: the row's
     // `verificationToken` is an ownership credential and is never re-sent here.
     'customDomain',
     // BE → all store users on every purchase-order write: create, update, cancel,

package/dist/store.d.ts

@@ -1665,6 +1665,7 @@ declare global {
          * that ran out) and the domain keeps serving, and stays the shop's canonical
          * address, until this instant. Then the hourly sweep tears it down: the row
          * stays `VERIFIED`, loses `provisioning`, and this field returns to `null`.
+         * Any other teardown (a deprovision, a revoke) removes it.
          * A domain that never went live gets no grace (the date is the moment of the
          * loss). `null` or absent = not in grace; a re-upgrade clears it.
          */
@@ -1681,9 +1682,14 @@ declare global {
      * `lastCheckedAt` / `startedAt` diagnostics, although this type admits them.
      *
      * Unlike `GET /store/domains`, a PENDING claim whose seven-day window has
-     * lapsed but which DynamoDB has not reaped yet is still listed.
+     * lapsed but which DynamoDB has not reaped yet is still listed (it still
+     * blocks every other store from the host until it is reaped), and carries
+     * `claimExpired: true` so staff can tell it from a live claim.
      */
-    type PlatformDomainRecord = Omit<DomainRecord, 'verificationToken'>;
+    type PlatformDomainRecord = Omit<DomainRecord, 'verificationToken'> & {
+        /** Present (always `true`) only on a PENDING claim whose seven-day window has lapsed. */
+        claimExpired?: true;
+    };
     /**
      * `GET /platform/stores/{storeId}/domains` (supervisorToken: SUPERVISOR,
      * MANAGER) — one store's custom domains plus its public address, so the

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "sinfactura-types",
-	"version": "1.10.651",
+	"version": "1.10.652",
 	"description": "Shared wire and entity contracts for the SINFACTURA platform.",
 	"type": "module",
 	"main": "dist/index.js",