test: the Assets Cloud suite, written to stand down

Assets needs Jira Service Management Premium, and jirajs-dev has no Service Management licence at all — the workspace
list comes back empty and there is nothing to point a client at. So this reports itself skipped rather than failing
five times over a plan, the shape tests/live/setup/entitlement.ts established for the same reason, and comes back the
moment the site is on Premium without an edit here.

It deliberately builds its own client rather than taking the shared one. That it has to is the thing worth showing:
Assets is the one surface that does not answer on the site's own host.

Author: MrRefactoring

tests/live/assets/assets.test.ts

@@ -0,0 +1,81 @@
+import { beforeAll, describe, expect, it } from 'vitest';
+import { createAssetsClient, type AssetsClient } from '#/assets/createAssetsClient';
+import { createServiceDeskClient } from '#/serviceDesk/createServiceDeskClient';
+import { getClient } from '../setup/client';
+import { requireLiveEnv } from '../setup/env';
+
+/**
+ * Live suite for the Assets Cloud API.
+ *
+ * Assets needs Jira Service Management Premium. On a site without it `getAssetsWorkspaces` answers with an empty
+ * list, and there is nothing to point a client at — so this stands down, visibly, rather than failing sixty times
+ * over a plan. That is the shape `tests/live/setup/entitlement.ts` established for the Cloud suites, and for the same
+ * reason: a suite that fails over an entitlement buries the signal it exists to carry.
+ *
+ * It comes back the moment the site is on Premium, without an edit here.
+ *
+ * The client is deliberately not `getClient()`. Assets is the one surface that does not answer on the site's own
+ * host, so it is built from its own configuration — and that this suite has to do so is itself the thing worth
+ * showing a reader.
+ */
+async function findWorkspace(): Promise<string | undefined> {
+  const serviceDesk = createServiceDeskClient(getClient());
+
+  try {
+    const page = await serviceDesk.assets.getAssetsWorkspaces({ limit: 1 });
+
+    return page.values?.[0]?.workspaceId;
+  } catch {
+    // A site with no Service Management at all refuses the lookup rather than answering it empty. Either way there
+    // is no workspace, which is the only thing this needs to know.
+    return undefined;
+  }
+}
+
+const workspaceId = await findWorkspace();
+
+describe.skipIf(workspaceId === undefined)('Assets — Cloud (live)', () => {
+  let assets: AssetsClient;
+
+  beforeAll(() => {
+    const { email, apiToken } = requireLiveEnv();
+
+    assets = createAssetsClient({ workspaceId: workspaceId!, auth: { type: 'basic', email, apiToken } });
+  });
+
+  it('lists the object schemas of the workspace', async () => {
+    const schemas = await assets.objectSchemas.findSchemas({ maxResults: 5 });
+
+    expect(Array.isArray(schemas.values)).toBe(true);
+  });
+
+  it('lists the global icons', async () => {
+    const icons = await assets.icons.findGlobalIcons();
+
+    expect(Array.isArray(icons)).toBe(true);
+  });
+
+  it('lists the status types', async () => {
+    const statuses = await assets.statusTypes.findStatusTypes();
+
+    expect(Array.isArray(statuses)).toBe(true);
+  });
+
+  it('reports what the tenant is using', async () => {
+    const usage = await assets.usage.getTenantUsageInfo();
+
+    expect(usage).toBeTypeOf('object');
+  });
+
+  it('counts objects by AQL', async () => {
+    const count = await assets.objects.countObjectsByAql({ qlQuery: 'objectType is not empty' });
+
+    expect(count.totalCount).toBeTypeOf('number');
+  });
+});
+
+describe.runIf(workspaceId === undefined)('Assets — Cloud (live)', () => {
+  it('stands down: the site has no Assets workspace', () => {
+    expect(workspaceId).toBeUndefined();
+  });
+});