@cleocode/core 2026.9.26 → 2026.10.2

package/dist/cloud/nexus-cloud.d.ts

@@ -0,0 +1,179 @@
+/**
+ * `cleo cloud whoami|devices|projects`: read-only Cleo Nexus reads with the
+ * device credential (cleo-nexus device contract v2.15, §4.2 E2, E5, E13, E14,
+ * E15; CLI mapping §4.4).
+ *
+ * - Every request is a `GET`. Nothing here writes to the server or to a
+ *   project store. The one side effect is the one every device-credential
+ *   command has: {@link ensureNexusDeviceCredential} retries unsettled
+ *   logouts and upgrades a 9.24 session once (§3.4, §3.5).
+ * - Lists follow `nextCursor` (§4.0.3) with the largest page the server takes,
+ *   up to a page budget, and report the server's `truncated` flags.
+ * - Failures are mapped by {@link nexusApiErrorToAccountError}, whose table
+ *   lives in `@cleocode/contracts` (§4.0.4).
+ *
+ * No function here logs, and no result or error carries a token.
+ *
+ * @task T12871
+ * @epic T12323
+ */
+import { type CloudDevicesResult, type CloudPaging, type CloudProjectShowResult, type CloudProjectsResult, type CloudWarning, type CloudWhoamiResult, type NexusCloudReplica, type NexusDeviceListState, type NexusProjectLink } from '@cleocode/contracts';
+import { type ResponseSchema } from './http.js';
+import { NexusDeviceStore, type SealedNexusDevice } from './nexus-device.js';
+import { type NexusDeviceCredentialOptions } from './nexus-enrol.js';
+/** Timeout of one `cleo cloud` request. */
+export declare const NEXUS_CLOUD_TIMEOUT_MS = 15000;
+/** Warning code for a non-fatal problem met while getting the device credential. */
+export declare const W_NEXUS_CREDENTIAL = "W_NEXUS_CREDENTIAL";
+/** Warning code: a list stopped at its page budget while the server had more. */
+export declare const W_NEXUS_PAGE_LIMIT = "W_NEXUS_PAGE_LIMIT";
+/** Warning code: a server ceiling cut a list (§4.0.3 `truncated`). */
+export declare const W_NEXUS_TRUNCATED = "W_NEXUS_TRUNCATED";
+/** Options shared by every `cleo cloud` read; all optional (tests inject them). */
+export interface NexusCloudOptions extends NexusDeviceCredentialOptions {
+    /** Project root; defaults to the current project (when there is one). */
+    projectRoot?: string;
+    /** Per-request timeout; default {@link NEXUS_CLOUD_TIMEOUT_MS}. */
+    timeoutMs?: number;
+    /** Most pages a list follows; default {@link NEXUS_CLOUD_MAX_PAGES}. */
+    maxPages?: number;
+    /** Page size sent as `limit`; default {@link NEXUS_PAGE_LIMIT_MAX}. */
+    pageLimit?: number;
+}
+/** A signed-in, read-only connection to the API. Holds the bearer inside {@link Http} only. */
+export interface NexusCloudConnection {
+    /** API origin. */
+    readonly apiUrl: string;
+    /** The device entry whose credential the requests carry. */
+    readonly device: SealedNexusDevice;
+    /** Warnings from getting the credential. */
+    readonly warnings: CloudWarning[];
+    /** `GET path`, parsed against `schema`; failures mapped per §4.0.4. */
+    get<T>(path: string, schema: ResponseSchema<T>): Promise<T>;
+    /** {@link NexusCloudConnection.get}, but a 404 `E_NOT_FOUND` answers `null`. */
+    find<T>(path: string, schema: ResponseSchema<T>): Promise<T | null>;
+}
+/** The current CLEO project, as far as the cloud reads need it. */
+export interface NexusCloudProject {
+    /** Project root. */
+    readonly root: string;
+    /** The tracked project id (`.cleo/project.json`, legacy `.cleo/project-id`). */
+    readonly projectId: string;
+    /** The `.cleo/nexus-link.json` entry for the origin, if any. */
+    readonly link: NexusProjectLink | null;
+    /** Path of `.cleo/nexus-link.json` (whether or not it exists). */
+    readonly linkPath: string;
+}
+/**
+ * Refuse with `E_NEXUS_DEVICE_REQUIRED` when device credentials are off
+ * (`CLEO_NEXUS_DEVICE=0`): the cloud reads never fall back to a 9.24 session.
+ *
+ * @throws {NexusAccountError} `E_NEXUS_DEVICE_REQUIRED`.
+ */
+export declare function assertNexusCloudDeviceMode(): void;
+/** Wrap credential warnings (plain strings) as envelope warnings. */
+export declare function nexusCredentialWarnings(warnings: readonly string[]): CloudWarning[];
+/**
+ * Open a read-only connection with this machine's device credential.
+ *
+ * @param opts - API URL, account, stores and test overrides.
+ * @returns The connection.
+ * @throws {NexusAccountError} `E_NEXUS_DEVICE_REQUIRED`, `E_NEXUS_NOT_SIGNED_IN`,
+ *   `E_NEXUS_ACCOUNT_AMBIGUOUS`, or an upgrade failure.
+ */
+export declare function connectNexusCloud(opts?: NexusCloudOptions): Promise<NexusCloudConnection>;
+/** A path with its query string; `undefined` values are left out. */
+export declare function nexusQueryPath(path: string, query: Readonly<Record<string, string | number | undefined>>): string;
+/** One page of a cursor-paged list. */
+interface Page {
+    readonly nextCursor: string | null;
+    readonly truncated: boolean;
+}
+/**
+ * Follow `nextCursor` until the server has no more or the budget is spent.
+ *
+ * @param fetchPage - Fetch the page after `cursor` (`null` for the first).
+ * @param maxPages - Page budget (at least 1).
+ * @returns Every page fetched and the paging facts.
+ */
+export declare function followNexusPages<P extends Page>(fetchPage: (cursor: string | null) => Promise<P>, maxPages: number): Promise<{
+    pages: P[];
+    paging: CloudPaging;
+}>;
+/** The warnings a list's paging facts call for. */
+export declare function nexusPagingWarnings(what: string, paging: CloudPaging): CloudWarning[];
+/**
+ * The current CLEO project, or `null` outside one (or without a project id).
+ *
+ * @param apiUrl - API origin whose link entry to read.
+ * @param projectRoot - Explicit project root; defaults to the current one.
+ * @returns The project, its id and link entry, or `null`.
+ */
+export declare function currentNexusCloudProject(apiUrl: string, projectRoot?: string): NexusCloudProject | null;
+/**
+ * `cleo cloud whoami`: E2 `GET /v1/whoami`.
+ *
+ * @param opts - API URL, account, stores and test overrides.
+ * @returns Who is calling: user, organizations, credential and device.
+ */
+export declare function nexusCloudWhoami(opts?: NexusCloudOptions): Promise<CloudWhoamiResult>;
+/** Options for {@link listNexusCloudDevices}. */
+export interface NexusCloudDevicesOptions extends NexusCloudOptions {
+    /** `--state`; the server's default (`active` for device callers) when absent. */
+    state?: NexusDeviceListState;
+}
+/**
+ * `cleo cloud devices`: E5 `GET /v1/devices`, every page.
+ *
+ * @param opts - State filter, paging and test overrides.
+ * @returns Every device, newest first, with paging facts.
+ */
+export declare function listNexusCloudDevices(opts?: NexusCloudDevicesOptions): Promise<CloudDevicesResult>;
+/** Options for {@link listNexusCloudProjects}. */
+export interface NexusCloudProjectsOptions extends NexusCloudOptions {
+    /** `--org`: only this organization's projects. */
+    organizationId?: string;
+}
+/**
+ * `cleo cloud projects`: E13 `GET /v1/projects`, every page.
+ *
+ * @param opts - Organization filter, paging and test overrides.
+ * @returns Every visible project, newest first, with paging facts.
+ */
+export declare function listNexusCloudProjects(opts?: NexusCloudProjectsOptions): Promise<CloudProjectsResult>;
+/**
+ * Every replica of a project from E15, following its cursors.
+ *
+ * @param conn - Connection.
+ * @param projectId - Project id.
+ * @param opts - Paging overrides.
+ * @returns The replicas, oldest attachment first, and the paging facts.
+ */
+export declare function listNexusCloudReplicas(conn: NexusCloudConnection, projectId: string, opts?: Pick<NexusCloudOptions, 'maxPages' | 'pageLimit'>): Promise<{
+    replicas: NexusCloudReplica[];
+    paging: CloudPaging;
+}>;
+/** Options for {@link showNexusCloudProject}. */
+export interface NexusCloudProjectShowOptions extends NexusCloudOptions {
+    /** The project; defaults to the current project. */
+    projectId?: string;
+}
+/**
+ * `cleo cloud projects show [<id>]`: E14 `GET /v1/projects/:projectId`. When
+ * E14 cut its replica list at 50, the full list is read from E15.
+ *
+ * @param opts - Project id (default: the current project), paging and test overrides.
+ * @returns The project detail.
+ * @throws {NexusAccountError} `E_NEXUS_NOT_A_PROJECT` with no id outside a
+ *   project; `E_NEXUS_REQUEST_FAILED` for an unknown or invisible project.
+ */
+export declare function showNexusCloudProject(opts?: NexusCloudProjectShowOptions): Promise<CloudProjectShowResult>;
+/**
+ * The device credential store's location, for reports (never its contents).
+ *
+ * @param store - The store in use, if injected.
+ * @returns Absolute path of `nexus-device.json`.
+ */
+export declare function nexusCloudCredentialsPath(store?: NexusDeviceStore): string;
+export {};
+//# sourceMappingURL=nexus-cloud.d.ts.map

package/dist/cloud/nexus-cloud.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus-cloud.d.ts","sourceRoot":"","sources":["../../src/cloud/nexus-cloud.ts"],"names":[],"mappings":"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"}

package/dist/cloud/nexus-cloud.js

@@ -0,0 +1,296 @@
+/**
+ * `cleo cloud whoami|devices|projects`: read-only Cleo Nexus reads with the
+ * device credential (cleo-nexus device contract v2.15, §4.2 E2, E5, E13, E14,
+ * E15; CLI mapping §4.4).
+ *
+ * - Every request is a `GET`. Nothing here writes to the server or to a
+ *   project store. The one side effect is the one every device-credential
+ *   command has: {@link ensureNexusDeviceCredential} retries unsettled
+ *   logouts and upgrades a 9.24 session once (§3.4, §3.5).
+ * - Lists follow `nextCursor` (§4.0.3) with the largest page the server takes,
+ *   up to a page budget, and report the server's `truncated` flags.
+ * - Failures are mapped by {@link nexusApiErrorToAccountError}, whose table
+ *   lives in `@cleocode/contracts` (§4.0.4).
+ *
+ * No function here logs, and no result or error carries a token.
+ *
+ * @task T12871
+ * @epic T12323
+ */
+import { NEXUS_CLOUD_MAX_PAGES, NEXUS_PAGE_LIMIT_MAX, nexusCloudDevicePageSchema, nexusCloudProjectDetailSchema, nexusCloudProjectPageSchema, nexusCloudReplicaPageSchema, nexusCloudWhoamiSchema, } from '@cleocode/contracts';
+import { readDeclaredProjectIdentity } from '@cleocode/paths';
+import { resolveOrCwd } from '../paths.js';
+import { Http, NexusError } from './http.js';
+import { NexusAccountError, resolveNexusApiUrl } from './nexus-auth.js';
+import { isNexusDeviceEnabled, NexusDeviceStore } from './nexus-device.js';
+import { ensureNexusDeviceCredential, nexusApiErrorToAccountError, } from './nexus-enrol.js';
+import { nexusLinkPath, readNexusProjectLink } from './nexus-link.js';
+/** Timeout of one `cleo cloud` request. */
+export const NEXUS_CLOUD_TIMEOUT_MS = 15_000;
+/** Warning code for a non-fatal problem met while getting the device credential. */
+export const W_NEXUS_CREDENTIAL = 'W_NEXUS_CREDENTIAL';
+/** Warning code: a list stopped at its page budget while the server had more. */
+export const W_NEXUS_PAGE_LIMIT = 'W_NEXUS_PAGE_LIMIT';
+/** Warning code: a server ceiling cut a list (§4.0.3 `truncated`). */
+export const W_NEXUS_TRUNCATED = 'W_NEXUS_TRUNCATED';
+/**
+ * Refuse with `E_NEXUS_DEVICE_REQUIRED` when device credentials are off
+ * (`CLEO_NEXUS_DEVICE=0`): the cloud reads never fall back to a 9.24 session.
+ *
+ * @throws {NexusAccountError} `E_NEXUS_DEVICE_REQUIRED`.
+ */
+export function assertNexusCloudDeviceMode() {
+    if (isNexusDeviceEnabled())
+        return;
+    throw new NexusAccountError('E_NEXUS_DEVICE_REQUIRED', '`cleo cloud` reads use the device credential, which CLEO_NEXUS_DEVICE=0 turns off', 'unset CLEO_NEXUS_DEVICE and run `cleo login nexus`');
+}
+/** Wrap credential warnings (plain strings) as envelope warnings. */
+export function nexusCredentialWarnings(warnings) {
+    return warnings.map((message) => ({ code: W_NEXUS_CREDENTIAL, message }));
+}
+/**
+ * Open a read-only connection with this machine's device credential.
+ *
+ * @param opts - API URL, account, stores and test overrides.
+ * @returns The connection.
+ * @throws {NexusAccountError} `E_NEXUS_DEVICE_REQUIRED`, `E_NEXUS_NOT_SIGNED_IN`,
+ *   `E_NEXUS_ACCOUNT_AMBIGUOUS`, or an upgrade failure.
+ */
+export async function connectNexusCloud(opts = {}) {
+    assertNexusCloudDeviceMode();
+    const apiUrl = resolveNexusApiUrl(opts.apiUrl);
+    const handle = await ensureNexusDeviceCredential({ ...opts, apiUrl });
+    const bearer = handle.device.currentBearer();
+    if (bearer === null) {
+        throw new NexusAccountError('E_NEXUS_NOT_SIGNED_IN', `not signed in to Cleo Nexus at ${apiUrl}`, 'run `cleo login nexus`');
+    }
+    const base = opts.fetch ?? ((input, init) => globalThis.fetch(input, init));
+    const timeoutMs = opts.timeoutMs ?? NEXUS_CLOUD_TIMEOUT_MS;
+    const timed = (input, init) => base(input, { ...init, signal: AbortSignal.timeout(timeoutMs) });
+    const http = new Http({ baseUrl: apiUrl, token: bearer, fetch: timed, maxAttempts: 1 });
+    return {
+        apiUrl,
+        device: handle.device,
+        warnings: nexusCredentialWarnings(handle.warnings),
+        async get(path, schema) {
+            try {
+                return await http.request('GET', path, schema);
+            }
+            catch (err) {
+                throw nexusApiErrorToAccountError(err);
+            }
+        },
+        async find(path, schema) {
+            try {
+                return await http.request('GET', path, schema);
+            }
+            catch (err) {
+                if (err instanceof NexusError && err.status === 404 && err.code === 'E_NOT_FOUND') {
+                    return null;
+                }
+                throw nexusApiErrorToAccountError(err);
+            }
+        },
+    };
+}
+/** A path with its query string; `undefined` values are left out. */
+export function nexusQueryPath(path, query) {
+    const params = new URLSearchParams();
+    for (const [k, v] of Object.entries(query))
+        if (v !== undefined)
+            params.set(k, String(v));
+    const qs = params.toString();
+    return qs === '' ? path : `${path}?${qs}`;
+}
+/**
+ * Follow `nextCursor` until the server has no more or the budget is spent.
+ *
+ * @param fetchPage - Fetch the page after `cursor` (`null` for the first).
+ * @param maxPages - Page budget (at least 1).
+ * @returns Every page fetched and the paging facts.
+ */
+export async function followNexusPages(fetchPage, maxPages) {
+    const pages = [];
+    let cursor = null;
+    const budget = Math.max(1, Math.floor(maxPages));
+    do {
+        const page = await fetchPage(cursor);
+        pages.push(page);
+        cursor = page.nextCursor;
+    } while (cursor !== null && pages.length < budget);
+    return {
+        pages,
+        paging: {
+            pages: pages.length,
+            truncated: pages.some((p) => p.truncated),
+            pageLimitReached: cursor !== null,
+        },
+    };
+}
+/** The warnings a list's paging facts call for. */
+export function nexusPagingWarnings(what, paging) {
+    const out = [];
+    if (paging.truncated) {
+        out.push({
+            code: W_NEXUS_TRUNCATED,
+            message: `the server cut the ${what} at its hard ceiling; counts in the rows are exact, the list is not`,
+        });
+    }
+    if (paging.pageLimitReached) {
+        out.push({
+            code: W_NEXUS_PAGE_LIMIT,
+            message: `stopped after ${paging.pages} page(s) of ${what}; the server has more`,
+        });
+    }
+    return out;
+}
+/**
+ * The current CLEO project, or `null` outside one (or without a project id).
+ *
+ * @param apiUrl - API origin whose link entry to read.
+ * @param projectRoot - Explicit project root; defaults to the current one.
+ * @returns The project, its id and link entry, or `null`.
+ */
+export function currentNexusCloudProject(apiUrl, projectRoot) {
+    let root;
+    try {
+        root = resolveOrCwd(projectRoot);
+    }
+    catch {
+        return null;
+    }
+    const identity = readDeclaredProjectIdentity(root);
+    if (!identity)
+        return null;
+    return {
+        root,
+        projectId: identity.projectId,
+        link: readNexusProjectLink(root, apiUrl),
+        linkPath: nexusLinkPath(root),
+    };
+}
+/**
+ * `cleo cloud whoami`: E2 `GET /v1/whoami`.
+ *
+ * @param opts - API URL, account, stores and test overrides.
+ * @returns Who is calling: user, organizations, credential and device.
+ */
+export async function nexusCloudWhoami(opts = {}) {
+    const conn = await connectNexusCloud(opts);
+    const whoami = await conn.get('/v1/whoami', nexusCloudWhoamiSchema);
+    return { apiUrl: conn.apiUrl, ...whoami, warnings: conn.warnings };
+}
+/**
+ * `cleo cloud devices`: E5 `GET /v1/devices`, every page.
+ *
+ * @param opts - State filter, paging and test overrides.
+ * @returns Every device, newest first, with paging facts.
+ */
+export async function listNexusCloudDevices(opts = {}) {
+    const conn = await connectNexusCloud(opts);
+    const limit = opts.pageLimit ?? NEXUS_PAGE_LIMIT_MAX;
+    const { pages, paging } = await followNexusPages((cursor) => conn.get(nexusQueryPath('/v1/devices', { limit, cursor: cursor ?? undefined, state: opts.state }), nexusCloudDevicePageSchema), opts.maxPages ?? NEXUS_CLOUD_MAX_PAGES);
+    const devices = pages.flatMap((p) => p.devices);
+    return {
+        apiUrl: conn.apiUrl,
+        state: opts.state ?? null,
+        devices,
+        count: devices.length,
+        paging,
+        warnings: [...conn.warnings, ...nexusPagingWarnings('device list', paging)],
+    };
+}
+/**
+ * `cleo cloud projects`: E13 `GET /v1/projects`, every page.
+ *
+ * @param opts - Organization filter, paging and test overrides.
+ * @returns Every visible project, newest first, with paging facts.
+ */
+export async function listNexusCloudProjects(opts = {}) {
+    const conn = await connectNexusCloud(opts);
+    const limit = opts.pageLimit ?? NEXUS_PAGE_LIMIT_MAX;
+    const { pages, paging } = await followNexusPages((cursor) => conn.get(nexusQueryPath('/v1/projects', {
+        limit,
+        cursor: cursor ?? undefined,
+        organizationId: opts.organizationId,
+    }), nexusCloudProjectPageSchema), opts.maxPages ?? NEXUS_CLOUD_MAX_PAGES);
+    const projects = pages.flatMap((p) => p.projects);
+    const full = { ...paging, projectsTruncated: pages.some((p) => p.projectsTruncated) };
+    return {
+        apiUrl: conn.apiUrl,
+        organizationId: opts.organizationId ?? null,
+        projects,
+        count: projects.length,
+        paging: full,
+        warnings: [...conn.warnings, ...nexusPagingWarnings('project list', paging)],
+    };
+}
+/**
+ * Every replica of a project from E15, following its cursors.
+ *
+ * @param conn - Connection.
+ * @param projectId - Project id.
+ * @param opts - Paging overrides.
+ * @returns The replicas, oldest attachment first, and the paging facts.
+ */
+export async function listNexusCloudReplicas(conn, projectId, opts = {}) {
+    const limit = opts.pageLimit ?? NEXUS_PAGE_LIMIT_MAX;
+    const { pages, paging } = await followNexusPages((cursor) => conn.get(nexusQueryPath(`/v1/projects/${encodeURIComponent(projectId)}/replicas`, {
+        limit,
+        cursor: cursor ?? undefined,
+    }), nexusCloudReplicaPageSchema), opts.maxPages ?? NEXUS_CLOUD_MAX_PAGES);
+    return { replicas: pages.flatMap((p) => p.replicas), paging };
+}
+/**
+ * `cleo cloud projects show [<id>]`: E14 `GET /v1/projects/:projectId`. When
+ * E14 cut its replica list at 50, the full list is read from E15.
+ *
+ * @param opts - Project id (default: the current project), paging and test overrides.
+ * @returns The project detail.
+ * @throws {NexusAccountError} `E_NEXUS_NOT_A_PROJECT` with no id outside a
+ *   project; `E_NEXUS_REQUEST_FAILED` for an unknown or invisible project.
+ */
+export async function showNexusCloudProject(opts = {}) {
+    const apiUrl = resolveNexusApiUrl(opts.apiUrl);
+    let projectId = opts.projectId;
+    const currentProject = projectId === undefined;
+    if (projectId === undefined) {
+        const project = currentNexusCloudProject(apiUrl, opts.projectRoot);
+        if (project === null) {
+            throw new NexusAccountError('E_NEXUS_NOT_A_PROJECT', 'no project id given and not inside a CLEO project', 'pass a project id (`cleo cloud projects show <id>`) or run it inside a CLEO project');
+        }
+        projectId = project.link?.remoteProjectId ?? project.projectId;
+    }
+    const conn = await connectNexusCloud({ ...opts, apiUrl });
+    const detail = await conn.get(`/v1/projects/${encodeURIComponent(projectId)}`, nexusCloudProjectDetailSchema);
+    let replicaPaging = {
+        pages: 0,
+        truncated: detail.truncated,
+        pageLimitReached: false,
+    };
+    let replicas = detail.replicas;
+    if (detail.truncated) {
+        const all = await listNexusCloudReplicas(conn, projectId, opts);
+        replicas = all.replicas;
+        replicaPaging = all.paging;
+    }
+    return {
+        ...detail,
+        replicas,
+        apiUrl: conn.apiUrl,
+        projectId,
+        currentProject,
+        replicaPaging,
+        warnings: [...conn.warnings, ...nexusPagingWarnings('replica list', replicaPaging)],
+    };
+}
+/**
+ * The device credential store's location, for reports (never its contents).
+ *
+ * @param store - The store in use, if injected.
+ * @returns Absolute path of `nexus-device.json`.
+ */
+export function nexusCloudCredentialsPath(store) {
+    return (store ?? new NexusDeviceStore()).location;
+}
+//# sourceMappingURL=nexus-cloud.js.map

package/dist/cloud/nexus-cloud.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nexus-cloud.js","sourceRoot":"","sources":["../../src/cloud/nexus-cloud.ts"],"names":[],"mappings":"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"}

package/dist/cloud/nexus-device.d.ts

@@ -81,10 +81,11 @@
  *   entry (`{ ...entry }`) produces an unguarded copy: T12868–T12871 must
  *   never spread an entry, or any part of one, into a log line or envelope.
  *
- * Behaviour that uses it ships behind `CLEO_NEXUS_DEVICE=1`
- * ({@link isNexusDeviceEnabled}): login enrolment and the 9.24 upgrade
- * (`nexus-enrol.ts`, T12868), then rotation, logout and the cloud reads
- * (T12869–T12871).
+ * Behaviour that uses it is on by default and switched off with
+ * `CLEO_NEXUS_DEVICE=0` ({@link isNexusDeviceEnabled}, T12904): login
+ * enrolment and the 9.24 upgrade (`nexus-enrol.ts`, T12868), logout and
+ * revoke (`nexus-logout.ts`, T12870), then rotation and the cloud reads
+ * (T12869, T12871).
  *
  * @task T12867
  * @epic T12323
@@ -216,8 +217,8 @@ declare const entrySchema: z.ZodObject<{
     enrolIntent: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         deviceId: z.ZodString;
         kind: z.ZodEnum<{
-            upgrade: "upgrade";
             login: "login";
+            upgrade: "upgrade";
         }>;
         /** Random id of the process that wrote it (a CAS token). */
         owner: z.ZodString;
@@ -261,10 +262,12 @@ export declare class NexusDeviceStoreError extends Error {
     constructor(code: NexusDeviceStoreErrorCode, message: string);
 }
 /**
- * Whether the device-credential behaviour is switched on (`CLEO_NEXUS_DEVICE=1`).
+ * Whether the device-credential login is on. It is the default (T12904);
+ * `CLEO_NEXUS_DEVICE=0` (or `false`, `off`, `no`) switches back to the 9.24
+ * session login. Status and logout always handle a stored device credential.
  *
  * @param env - Environment to read; defaults to `process.env`.
- * @returns `true` only for the exact value `1`.
+ * @returns `false` only for an off value.
  */
 export declare function isNexusDeviceEnabled(env?: NodeJS.ProcessEnv): boolean;
 /**
@@ -552,6 +555,28 @@ export declare function applyBeginRevoke(entry: NexusDeviceEntry, now?: Date): N
  * @returns The updated entry, guarded.
  */
 export declare function applySignOutConfirmed(entry: NexusDeviceEntry): NexusDeviceEntry;
+/**
+ * Forget this device locally after a revoke ended (contract §3.5, L6): the
+ * server confirmed it, found the device signed out (E10 401
+ * `device-signed-out`, v2.13), or refused every credential as dead. The keys,
+ * every credential and every slot go, so the next login enrols a fresh
+ * device id and can never re-activate the one the user asked to burn. Only
+ * `retired` survives, because those requests may still hold live credentials
+ * of other devices; the caller deletes the whole entry when there are none.
+ *
+ * @param entry - The entry read under the lock.
+ * @returns The stripped entry, guarded.
+ */
+export declare function applyForgetDevice(entry: NexusDeviceEntry): NexusDeviceEntry;
+/**
+ * Whether an entry holds nothing worth keeping: no keys, no credential, no
+ * slot and no retired request (left by {@link applyForgetDevice} once its
+ * retired requests settled).
+ *
+ * @param entry - The entry read under the lock.
+ * @returns `true` when the entry can be deleted.
+ */
+export declare function isForgottenDevice(entry: NexusDeviceEntry): boolean;
 /**
  * Settle a confirmed sign-out or revoke of a retired device.
  *

package/dist/cloud/nexus-device.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nexus-device.d.ts","sourceRoot":"","sources":["../../src/cloud/nexus-device.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0FG;AAuBH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,qFAAqF;AACrF,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD;;;GAGG;AACH,eAAO,MAAM,+BAA+B,QAA+B,CAAC;AAE5E,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,oIAStB,CAAC;AAEX,4DAA4D;AAC5D,eAAO,MAAM,qBAAqB,kCAAmC,CAAC;AAEtE,gGAAgG;AAChG,eAAO,MAAM,yBAAyB,+BAAgC,CAAC;AAEvE;;;;GAIG;AACH,eAAO,MAAM,iCAAiC,IAAI,CAAC;AAEnD,uFAAuF;AACvF,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,uEAAuE;AACvE,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,2FAA2F;AAC3F,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAwGjD,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QApDT,8FAA8F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmBlG;;;OAGG;IACH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;;;;;;;QAeC,4DAA4D;;;;iBASJ,CAAC;AAOjE,0FAA0F;AAC1F,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAC3D,kDAAkD;AAClD,MAAM,MAAM,eAAe,GAAG,WAAW,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;AACpE,qDAAqD;AACrD,MAAM,MAAM,kBAAkB,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;AAC/D,yEAAyE;AACzE,MAAM,MAAM,4BAA4B,GAAG,WAAW,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;AACpF,iFAAiF;AACjF,MAAM,MAAM,4BAA4B,GAAG,WAAW,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;AACpF,kEAAkE;AAClE,MAAM,MAAM,qBAAqB,GAAG,WAAW,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,CAAC;AACpF,wDAAwD;AACxD,MAAM,MAAM,yBAAyB,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AACrF,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,GAAG,WAAW,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AAClF,oEAAoE;AACpE,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAAC,CAAC;AAClF,2DAA2D;AAC3D,MAAM,MAAM,wBAAwB,GAAG,WAAW,CAAC,gBAAgB,CAAC,eAAe,CAAC,CAAC,CAAC;AAGtF,mCAAmC;AACnC,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AACxE,iCAAiC;AACjC,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,sDAAsD;AACtD,MAAM,MAAM,yBAAyB,GACjC,iCAAiC,GACjC,4BAA4B,GAC5B,6BAA6B,GAC7B,2BAA2B,GAC3B,2BAA2B,GAC3B,6BAA6B,GAC7B,8BAA8B,GAC9B,4BAA4B,GAC5B,mBAAmB,GACnB,8BAA8B,GAC9B,+BAA+B,GAC/B,+BAA+B,GAC/B,0BAA0B,GAC1B,qBAAqB,GACrB,0BAA0B,GAC1B,iCAAiC,CAAC;AAEtC,4FAA4F;AAC5F,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IAEzC;;;OAGG;gBACS,IAAI,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM;CAK7D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAElF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM7D;AAwDD;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAEtD;AAOD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGvF;AAED;;;;;GAKG;AACH,qBAAa,iBAAiB;;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,QAAQ;IACzB,kBAAkB;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAG1B;;;;OAIG;gBACS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB;IAOnE,uFAAuF;IACvF,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B,0FAA0F;IAC1F,aAAa,IAAI,MAAM,GAAG,IAAI;IAI9B;;;OAGG;IACH,MAAM,IAAI,gBAAgB;IAI1B,6BAA6B;IAC7B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIjC,+BAA+B;IAC/B,QAAQ,IAAI,MAAM;IAIlB,uCAAuC;IACvC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM;CAG3B;AAED;;;;GAIG;AACH,qBAAa,oBAAoB;;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAI1B;;;;OAIG;gBACS,KAAK,EAAE;QACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAAC;QACtC,QAAQ,CAAC,UAAU,EAAE,4BAA4B,CAAC;KACnD;IAgBD,6CAA6C;IAC7C,IAAI,IAAI,eAAe,GAAG,IAAI;IAI9B,+CAA+C;IAC/C,UAAU,IAAI,4BAA4B;IAI1C,6BAA6B;IAC7B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASjC,+BAA+B;IAC/B,QAAQ,IAAI,MAAM;IAIlB,uCAAuC;IACvC,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,MAAM;CAG3B;AAiDD;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAO7F;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,gBAAgB,GAAG,IAAI,EAC9B,SAAS,EAAE,oBAAoB,EAC/B,GAAG,GAAE,IAAiB,GACrB,gBAAgB,CAyBlB;AA+CD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,gBAAgB,GAAG,IAAI,EAC9B,QAAQ,EAAE;IACR,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;CACzC,EACD,GAAG,GAAE,IAAiB,GACrB,gBAAgB,CAqBlB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAG9F;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAGhG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,MAAM,EACb,GAAG,GAAE,IAAiB,GACrB,gBAAgB,GAAG,IAAI,CAIzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,gBAAgB,EACvB,SAAS,EAAE,wBAAwB,GAClC,gBAAgB,CAIlB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,gBAAgB,EACvB,YAAY,EAAE,MAAM,GACnB,gBAAgB,CAGlB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,MAAM,EAChB,GAAG,GAAE,IAAiB,GACrB,gBAAgB,CAmBlB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,gBAAgB,EACvB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACnB,gBAAgB,CAYlB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,GAAG,gBAAgB,CAGjG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,gBAAgB,EACvB,GAAG,GAAE,IAAiB,GACrB,gBAAgB,CAgBlB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,gBAAgB,EACvB,GAAG,GAAE,IAAiB,GACrB,gBAAgB,CAkBlB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAE/E;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAC/B,gBAAgB,CAMlB;AA2FD,4FAA4F;AAC5F,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAC7D,yFAAyF;IACzF,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnE;;;;OAIG;IACH,MAAM,CACJ,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAC5E,OAAO,CAAC;IACX;;;;;;;;;OASG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;OAIG;IACH,IAAI,IAAI,KAAK,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAChG;;;;;;;;;OASG;IACH,iBAAiB,CACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACtC;QAAE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACpE;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,wGAAwG;AACxG,qBAAa,qBAAqB;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,SAAS;IAC1B,kBAAkB;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qBAAqB;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;;OAKG;gBACS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM;CAMpF;AAED,6FAA6F;AAC7F,MAAM,WAAW,uBAAuB;IACtC,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,0FAA0F;IAC1F,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAKD;;;GAGG;AACH,qBAAa,gBAAgB;;IAC3B,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAK1B;;;OAGG;gBACS,IAAI,GAAE,MAA0B,EAAE,OAAO,GAAE,uBAA4B;IAOnF;;;;;;;;OAQG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAQ5E;;;;;;;OAOG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG,qBAAqB,CAAC,CAAC;IAmCvE;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACG,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,sBAAsB,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAwD/E,uEAAuE;YACzD,QAAQ;IAuItB;;;;;;;OAOG;YACW,QAAQ;IAYtB;;;;;OAKG;IACH,OAAO,CAAC,IAAI;IAqCZ;;;OAGG;IACH,OAAO,CAAC,IAAI;IAuBZ;;;;;OAKG;IACH,OAAO,CAAC,UAAU;IAuClB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAwDnB,uEAAuE;IACvE,OAAO,CAAC,WAAW;IAInB,kCAAkC;IAClC,OAAO,CAAC,YAAY;IAOpB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,mBAAmB;IA8C3B;;;;;;;;OAQG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;OAKG;IACH,OAAO,CAAC,WAAW;IAyCnB;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAiCZ;;;OAGG;IACH,OAAO,CAAC,cAAc;IAkBtB;;;;OAIG;IACH,OAAO,CAAC,YAAY;CAkBrB"}
+{"version":3,"file":"nexus-device.d.ts","sourceRoot":"","sources":["../../src/cloud/nexus-device.ts"],"names":[],"mappings":"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"}