@withpotter/lib 0.13.0-next.62 → 0.13.0-next.64

package/dist/__fixtures__/demo-content-server.json

@@ -0,0 +1,484 @@
+{
+  "status_none": {
+    "status": 200,
+    "body": {
+      "state": "none"
+    }
+  },
+  "available_no_pack": {
+    "status": 200,
+    "body": {
+      "available": false,
+      "template": "atelier-fashion-01",
+      "state": "none",
+      "reason": "no_pack"
+    }
+  },
+  "error_not_owner_or_admin": {
+    "status": 403,
+    "body": {
+      "statusCode": 403,
+      "code": "not_owner_or_admin",
+      "message": "Only the owner or an admin of this store can change demo content."
+    }
+  },
+  "error_clear_nothing": {
+    "status": 404,
+    "body": {
+      "statusCode": 404,
+      "code": "no_demo_content",
+      "message": "There is no demo content to clear."
+    }
+  },
+  "error_invalid_body": {
+    "status": 400,
+    "body": {
+      "statusCode": 400,
+      "code": "invalid_body",
+      "message": "Unknown field \"nope\"."
+    }
+  },
+  "available_ok": {
+    "status": 200,
+    "body": {
+      "available": true,
+      "template": "atelier-fashion-01",
+      "state": "none",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "name": "Atelier starter",
+        "description": "A small fashion store",
+        "version": "1.0.0",
+        "audience": "starter",
+        "locale": "en-NG",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "summary": {
+        "products": 2,
+        "collections": 1,
+        "contentItems": 0,
+        "pages": 1,
+        "images": 3,
+        "shipping": true
+      }
+    }
+  },
+  "dry_run": {
+    "status": 200,
+    "body": {
+      "dryRun": true,
+      "pack": {
+        "id": "atelier-fashion-01",
+        "version": "1.0.0",
+        "audience": "starter",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "plan": {
+        "products": {
+          "create": 2,
+          "update": 0,
+          "unchanged": 0,
+          "conflict": 0
+        },
+        "collections": {
+          "create": 1,
+          "update": 0,
+          "unchanged": 0,
+          "conflict": 0
+        },
+        "contentItems": {
+          "create": 0,
+          "update": 0,
+          "unchanged": 0,
+          "conflict": 0
+        },
+        "pages": {
+          "write": 3,
+          "skip": 0
+        },
+        "media": 3,
+        "shipping": "create"
+      },
+      "conflicts": [],
+      "skippedPages": []
+    }
+  },
+  "apply_202": {
+    "status": 202,
+    "body": {
+      "jobId": "30ac04a6-f11b-4888-a769-84e401dfc8df",
+      "state": "applying",
+      "resumed": false
+    }
+  },
+  "status_applying": {
+    "status": 200,
+    "body": {
+      "state": "applying",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "template": "atelier-fashion-01",
+        "audience": "",
+        "hash": ""
+      },
+      "progress": {
+        "phase": "fetching",
+        "done": 0,
+        "total": 0
+      },
+      "startedAt": "2026-10-30T05:44:58.977Z",
+      "job": "apply",
+      "counts": {
+        "products": 0,
+        "collections": 0,
+        "pages": 0,
+        "media": 0
+      }
+    }
+  },
+  "error_job_in_progress": {
+    "status": 409,
+    "body": {
+      "statusCode": 409,
+      "code": "job_in_progress",
+      "message": "Demo content is already being changed. Wait for it to finish.",
+      "details": {
+        "job": "apply"
+      }
+    }
+  },
+  "error_adopt_busy": {
+    "status": 409,
+    "body": {
+      "statusCode": 409,
+      "code": "job_in_progress",
+      "message": "Demo content is already being changed. Wait for it to finish.",
+      "details": {
+        "job": "apply"
+      }
+    }
+  },
+  "status_applied": {
+    "status": 200,
+    "body": {
+      "state": "applied",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "template": "atelier-fashion-01",
+        "version": "1.0.0",
+        "audience": "starter",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "progress": {
+        "phase": "activating",
+        "done": 3,
+        "total": 3
+      },
+      "startedAt": "2026-10-30T05:44:58.977Z",
+      "job": "apply",
+      "finishedAt": "2026-10-30T05:44:58.983Z",
+      "counts": {
+        "products": 2,
+        "collections": 1,
+        "pages": 1,
+        "media": 2
+      }
+    }
+  },
+  "available_after_apply": {
+    "status": 200,
+    "body": {
+      "available": true,
+      "template": "atelier-fashion-01",
+      "state": "applied",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "name": "Atelier starter",
+        "description": "A small fashion store",
+        "version": "1.0.0",
+        "audience": "starter",
+        "locale": "en-NG",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "summary": {
+        "products": 2,
+        "collections": 1,
+        "contentItems": 0,
+        "pages": 1,
+        "images": 3,
+        "shipping": true
+      }
+    }
+  },
+  "sample_product": {
+    "id": "id-1",
+    "type": "physical",
+    "slug": "classic-tee",
+    "title": "Classic tee",
+    "tags": [
+      "demo-pack",
+      "demo-pack:atelier-fashion-01"
+    ],
+    "data": {
+      "demoPack": {
+        "id": "atelier-fashion-01",
+        "ref": "tee"
+      }
+    },
+    "isActive": true
+  },
+  "sample_collection": {
+    "id": "id-3",
+    "type": "collections",
+    "slug": "tops",
+    "title": "Tops",
+    "tags": [
+      "demo-pack",
+      "demo-pack:atelier-fashion-01"
+    ],
+    "data": {
+      "productIds": [
+        "id-1"
+      ],
+      "demoPack": {
+        "id": "atelier-fashion-01",
+        "ref": "tops"
+      }
+    },
+    "isActive": true
+  },
+  "adopt_200": {
+    "status": 200,
+    "body": {
+      "adopted": {
+        "products": [
+          "id-1"
+        ],
+        "collections": [],
+        "contentItems": []
+      },
+      "notFound": [
+        "ghost"
+      ]
+    }
+  },
+  "sample_product_after_adopt": {
+    "id": "id-1",
+    "type": "physical",
+    "slug": "classic-tee",
+    "title": "Classic tee",
+    "tags": [],
+    "data": {},
+    "isActive": true
+  },
+  "error_nothing_to_adopt": {
+    "status": 400,
+    "body": {
+      "statusCode": 400,
+      "code": "nothing_to_adopt",
+      "message": "Name at least one item to keep, or pass all: true."
+    }
+  },
+  "clear_202": {
+    "status": 202,
+    "body": {
+      "jobId": "6764bb70-2a79-4047-9bb8-760802c6a10d",
+      "state": "clearing",
+      "resumed": false
+    }
+  },
+  "status_clearing": {
+    "status": 200,
+    "body": {
+      "state": "clearing",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "template": "atelier-fashion-01",
+        "version": "1.0.0",
+        "audience": "starter",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "progress": {
+        "phase": "catalogue",
+        "done": 0,
+        "total": 0
+      },
+      "startedAt": "2026-10-30T05:44:58.984Z",
+      "job": "clear",
+      "counts": {
+        "products": 1,
+        "collections": 1,
+        "pages": 1,
+        "media": 2
+      }
+    }
+  },
+  "status_after_clear": {
+    "status": 200,
+    "body": {
+      "state": "none",
+      "orphanedMedia": {
+        "count": 2,
+        "clearedAt": "2026-10-30T05:44:58.985Z"
+      }
+    }
+  },
+  "status_failed_apply": {
+    "status": 200,
+    "body": {
+      "state": "failed",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "template": "atelier-fashion-01",
+        "version": "1.0.0",
+        "audience": "starter",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "progress": {
+        "phase": "products",
+        "done": 1,
+        "total": 2
+      },
+      "startedAt": "2026-10-30T05:44:58.992Z",
+      "job": "apply",
+      "finishedAt": "2026-10-30T05:44:59.006Z",
+      "counts": {
+        "products": 1,
+        "collections": 0,
+        "pages": 0,
+        "media": 2
+      },
+      "error": {
+        "code": "internal",
+        "message": "Something went wrong while adding the demo content. Try again."
+      }
+    }
+  },
+  "apply_resumed": {
+    "status": 202,
+    "body": {
+      "jobId": "ebc57efe-f23d-407b-9136-158bc45b761f",
+      "state": "applying",
+      "resumed": true
+    }
+  },
+  "status_applied_skipped": {
+    "status": 200,
+    "body": {
+      "state": "applied",
+      "pack": {
+        "id": "atelier-fashion-01",
+        "template": "atelier-fashion-01",
+        "version": "1.0.0",
+        "audience": "starter",
+        "hash": "8a250f256273eae1183683684d411baba581c483f382727fef07872428fb8fe0"
+      },
+      "progress": {
+        "phase": "activating",
+        "done": 3,
+        "total": 3
+      },
+      "startedAt": "2026-10-30T05:44:59.017Z",
+      "job": "apply",
+      "finishedAt": "2026-10-30T05:44:59.019Z",
+      "counts": {
+        "products": 2,
+        "collections": 1,
+        "pages": 0,
+        "media": 2
+      },
+      "skippedPages": [
+        "home"
+      ]
+    }
+  },
+  "error_pack_hash_mismatch": {
+    "status": 422,
+    "body": {
+      "statusCode": 422,
+      "code": "pack_hash_mismatch",
+      "message": "The downloaded pack does not match its published checksum."
+    }
+  },
+  "error_pack_branded_assets": {
+    "status": 422,
+    "body": {
+      "statusCode": 422,
+      "code": "pack_branded_assets",
+      "message": "A starter pack cannot contain branded pictures.",
+      "details": {
+        "assets": [
+          "hero",
+          "tee",
+          "tee2"
+        ]
+      }
+    }
+  },
+  "error_rate_limited": {
+    "status": 429,
+    "body": {
+      "statusCode": 429,
+      "code": "rate_limited",
+      "message": "Demo content was applied too often. Try again later.",
+      "details": {
+        "retryAfterSeconds": 3600
+      }
+    }
+  },
+  "enums": {
+    "states": [
+      "none",
+      "applying",
+      "applied",
+      "clearing",
+      "failed"
+    ],
+    "jobs": [
+      "apply",
+      "clear"
+    ],
+    "phases": [
+      "fetching",
+      "media",
+      "products",
+      "collections",
+      "content",
+      "tenant",
+      "pages",
+      "shipping",
+      "pruning",
+      "activating",
+      "catalogue",
+      "settings"
+    ],
+    "errorCodes": [
+      "invalid_body",
+      "not_owner_or_admin",
+      "showroom_not_allowed",
+      "pack_url_forbidden",
+      "pack_url_invalid",
+      "pack_host_not_allowed",
+      "template_mismatch",
+      "no_pack",
+      "no_demo_content",
+      "job_in_progress",
+      "other_pack_present",
+      "pack_invalid",
+      "pack_branded_assets",
+      "pack_hash_mismatch",
+      "pack_too_large",
+      "pack_fetch_failed",
+      "quota_exceeded",
+      "rate_limited",
+      "nothing_to_adopt",
+      "interrupted",
+      "internal"
+    ]
+  },
+  "marker": {
+    "tag": "demo-pack",
+    "packTag": "demo-pack:atelier-fashion-01"
+  },
+  "_about": "Generated by running @withpotter/demo-content (api-next PR #620) through its real controller, guards and use cases against the in-memory world of its own specs."
+}

package/dist/admin-api.d.ts

@@ -252,6 +252,11 @@ export interface PlatformCockpit {
         performanceSeriesByCurrency?: CurrencySeries[];
     };
     attention: {
+        /**
+         * Feeds whose query failed; their counts are placeholders, not zeros.
+         * Absent when talking to an API that predates this field.
+         */
+        unavailable?: Array<'needsReview' | 'dormantTenants' | 'overdueInvoices' | 'failedSettlements'>;
         trialsEndingSoon: Array<AttentionTenantRef & {
             trialEndsAt: string;
             daysLeft: number;
@@ -299,6 +304,8 @@ export interface PlatformRevenue {
     };
     currency: string;
     recurring: {
+        /** False when no billing source feeds the figures below (all are 0). */
+        tracked?: boolean;
         mrr: number;
         arr: number;
         arpa: number;