@empire-builder-kit/nx 1.0.0-beta.9 → 1.0.0-rc.2

package/src/local-dev/fleet-session.js

@@ -0,0 +1,301 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FleetSession = void 0;
+const deterministic_order_js_1 = require("../deterministic-order.js");
+const errors_js_1 = require("./errors.js");
+const slice_claim_js_1 = require("./slice-claim.js");
+function sessionError(classification, message) {
+    throw new errors_js_1.LocalDevContractError(classification, message);
+}
+class FleetSession {
+    routes;
+    #allocatePort;
+    #claimOwner;
+    #cleanupStates = new Map();
+    #fleetId;
+    #operation = Promise.resolve();
+    #processFactory;
+    #processes = new Map();
+    #proxy;
+    #proxyPort;
+    #security;
+    #sessionGeneration;
+    #sliceClaimsDirectory;
+    #started = false;
+    constructor(options) {
+        this.#allocatePort = options.allocatePort;
+        this.#fleetId = options.fleetId;
+        this.#processFactory = options.processFactory;
+        this.#proxy = options.proxy;
+        this.#proxyPort = options.proxyPort;
+        this.#security = options.security ?? {};
+        this.#sessionGeneration = options.sessionGeneration;
+        this.#sliceClaimsDirectory = options.sliceClaimsDirectory;
+        this.#claimOwner = {
+            fleetId: options.fleetId,
+            owner: options.supervisor,
+            sessionGeneration: options.sessionGeneration,
+        };
+        this.routes =
+            options.routes ??
+                [...options.adapters]
+                    .sort(([left], [right]) => (0, deterministic_order_js_1.compareUtf16)(left, right))
+                    .map(([name, adapter]) => ({
+                    adapter,
+                    name,
+                    selected: false,
+                    state: 'remote',
+                }));
+        for (const route of this.routes) {
+            this.#cleanupStates.set(route.name, route.adapter.adapterVersion === 2 && route.adapter.lifecycle
+                ? 'pending'
+                : 'not-declared');
+        }
+        if (this.routes.length !== options.adapters.size ||
+            this.routes.some(({ adapter, name, selected, state }) => adapter !== options.adapters.get(name) ||
+                selected ||
+                state !== 'remote')) {
+            throw new errors_js_1.LocalDevContractError('invalid-state', 'Fleet session routes must exactly match the validated unselected adapter plan.');
+        }
+    }
+    async start() {
+        if (this.#started)
+            return;
+        await this.#proxy.listen(this.#proxyPort);
+        this.#started = true;
+    }
+    #route(name) {
+        const route = this.routes.find((entry) => entry.name === name);
+        if (!route) {
+            throw new errors_js_1.LocalDevContractError('unknown-slice', `Product Slice ${name} is not in the validated Fleet plan.`);
+        }
+        return route;
+    }
+    #serialized(operation) {
+        const result = this.#operation.then(operation, operation);
+        this.#operation = result.then(() => undefined, () => undefined);
+        return result;
+    }
+    up(names) {
+        return this.#serialized(async () => {
+            const requested = [...new Set(names)].sort();
+            if (requested.length !== names.length || requested.length === 0) {
+                return sessionError('invalid-input', 'Fleet up requires unique non-empty Slice names.');
+            }
+            const changed = requested.filter((name) => !this.#route(name).selected);
+            if (changed.length === 0) {
+                return requested.map((name) => {
+                    const route = this.#route(name);
+                    return {
+                        changed: false,
+                        name,
+                        previousState: route.state,
+                        state: route.state,
+                    };
+                });
+            }
+            const acquisition = (0, slice_claim_js_1.acquireSliceClaims)(this.#sliceClaimsDirectory, changed, this.#claimOwner, { security: this.#security });
+            try {
+                for (const name of changed) {
+                    const route = this.#route(name);
+                    const port = await this.#allocatePort(name);
+                    route.upstream = new URL(`http://127.0.0.1:${port}`);
+                    route.selected = true;
+                    route.state = 'starting';
+                    this.#cleanupStates.set(name, route.adapter.adapterVersion === 2 && route.adapter.lifecycle
+                        ? 'pending'
+                        : 'not-declared');
+                    const process = this.#processFactory({
+                        adapter: route.adapter,
+                        name,
+                        onStateChange: (state) => {
+                            route.state = state;
+                            route.selected = state !== 'remote';
+                        },
+                        upstream: route.upstream,
+                    });
+                    this.#processes.set(name, process);
+                    await process.start();
+                }
+            }
+            catch (error) {
+                const cleanupFailures = [];
+                const releasable = [];
+                for (const name of [...changed].reverse()) {
+                    const process = this.#processes.get(name);
+                    if (process) {
+                        try {
+                            await process.stop({ cleanup: true });
+                            this.#processes.delete(name);
+                        }
+                        catch (cleanupError) {
+                            const route = this.#route(name);
+                            route.selected = true;
+                            route.state = 'unavailable';
+                            this.#cleanupStates.set(name, 'failed');
+                            cleanupFailures.push(`${name}: ${cleanupError instanceof Error
+                                ? cleanupError.message
+                                : String(cleanupError)}`);
+                            continue;
+                        }
+                    }
+                    const route = this.#route(name);
+                    route.selected = false;
+                    route.state = 'remote';
+                    this.#cleanupStates.set(name, route.adapter.adapterVersion === 2 && route.adapter.lifecycle
+                        ? 'succeeded'
+                        : 'not-declared');
+                    delete route.upstream;
+                    if (acquisition.acquired.includes(name))
+                        releasable.push(name);
+                }
+                for (const name of releasable) {
+                    try {
+                        (0, slice_claim_js_1.releaseSliceClaims)(this.#sliceClaimsDirectory, [name], this.#claimOwner, this.#security);
+                    }
+                    catch (releaseError) {
+                        cleanupFailures.push(`${name} claim: ${releaseError instanceof Error
+                            ? releaseError.message
+                            : String(releaseError)}`);
+                    }
+                }
+                if (cleanupFailures.length > 0) {
+                    return sessionError('cleanup-incomplete', `Fleet startup failed and generation-owned rollback was incomplete: ${cleanupFailures.join('; ')}`);
+                }
+                throw error;
+            }
+            return requested.map((name) => {
+                const route = this.#route(name);
+                return {
+                    changed: changed.includes(name),
+                    name,
+                    previousState: changed.includes(name) ? 'remote' : route.state,
+                    state: route.state,
+                };
+            });
+        });
+    }
+    restart(names) {
+        return this.#serialized(async () => {
+            if (names.length === 0 || new Set(names).size !== names.length) {
+                return sessionError('invalid-input', 'Fleet restart requires unique selected Slice names.');
+            }
+            const results = [];
+            for (const name of [...names].sort()) {
+                const route = this.#route(name);
+                const process = this.#processes.get(name);
+                if (!route.selected || !process) {
+                    return sessionError('not-running', `Product Slice ${name} is not selected.`);
+                }
+                const previousState = route.state;
+                await process.restart();
+                results.push({
+                    changed: true,
+                    name,
+                    previousState,
+                    state: route.state,
+                });
+            }
+            return results;
+        });
+    }
+    down(names) {
+        return this.#serialized(async () => {
+            if (names.length === 0 || new Set(names).size !== names.length) {
+                return sessionError('invalid-input', 'Fleet down requires unique selected Slice names.');
+            }
+            const results = [];
+            const cleanupFailures = [];
+            for (const name of [...names].sort().reverse()) {
+                const route = this.#route(name);
+                const process = this.#processes.get(name);
+                const previousState = route.state;
+                if (!route.selected || !process) {
+                    results.push({
+                        changed: false,
+                        name,
+                        previousState,
+                        state: route.state,
+                    });
+                    continue;
+                }
+                try {
+                    await process.stop({ cleanup: true });
+                    (0, slice_claim_js_1.releaseSliceClaims)(this.#sliceClaimsDirectory, [name], this.#claimOwner, this.#security);
+                    this.#processes.delete(name);
+                    route.selected = false;
+                    route.state = 'remote';
+                    this.#cleanupStates.set(name, route.adapter.adapterVersion === 2 && route.adapter.lifecycle
+                        ? 'succeeded'
+                        : 'not-declared');
+                    delete route.upstream;
+                    results.push({
+                        changed: true,
+                        name,
+                        previousState,
+                        state: 'remote',
+                    });
+                }
+                catch (error) {
+                    route.selected = true;
+                    route.state = 'unavailable';
+                    this.#cleanupStates.set(name, 'failed');
+                    cleanupFailures.push(`${name}: ${error instanceof Error ? error.message : String(error)}`);
+                    results.push({
+                        changed: false,
+                        name,
+                        previousState,
+                        state: 'unavailable',
+                    });
+                }
+            }
+            if (cleanupFailures.length > 0) {
+                return sessionError('cleanup-incomplete', `Fleet cleanup is incomplete; Slice claims were retained: ${cleanupFailures.join('; ')}`);
+            }
+            return results;
+        });
+    }
+    selectedSlices() {
+        return this.routes
+            .filter(({ selected }) => selected)
+            .map(({ name }) => name)
+            .sort();
+    }
+    allSlices() {
+        return this.routes.map(({ name }) => name).sort();
+    }
+    snapshot() {
+        return {
+            fleetId: this.#fleetId,
+            routes: this.routes.map(({ name, selected, state, upstream }) => {
+                const process = this.#processes.get(name);
+                const cleanup = process?.cleanup ??
+                    this.#cleanupStates.get(name) ??
+                    'not-declared';
+                this.#cleanupStates.set(name, cleanup);
+                return {
+                    cleanup,
+                    name,
+                    restartAttempts: process?.restartAttempts ?? 0,
+                    ...(process?.runnerGeneration
+                        ? { runnerGeneration: process.runnerGeneration }
+                        : {}),
+                    selected,
+                    state,
+                    ...(upstream ? { upstream: upstream.toString() } : {}),
+                };
+            }),
+            sessionGeneration: this.#sessionGeneration,
+        };
+    }
+    async closeProxyWhenEmpty() {
+        await this.#operation;
+        if (this.selectedSlices().length > 0 || !this.#started)
+            return false;
+        await this.#proxy.close();
+        this.#started = false;
+        return true;
+    }
+}
+exports.FleetSession = FleetSession;
+//# sourceMappingURL=fleet-session.js.map

package/src/local-dev/fleet-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-session.js","sourceRoot":"","sources":["../../../../../packages/nx/src/local-dev/fleet-session.ts"],"names":[],"mappings":"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"}

package/src/local-dev/fleet-slice-runner-daemon.d.ts

@@ -0,0 +1 @@
+export declare function runFleetSliceRunnerDaemon(requestPath?: string): Promise<0 | 1>;

package/src/local-dev/fleet-slice-runner-daemon.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runFleetSliceRunnerDaemon = runFleetSliceRunnerDaemon;
+const slice_runner_js_1 = require("./slice-runner.js");
+async function runFleetSliceRunnerDaemon(requestPath = process.env.EBK_FLEET_SLICE_RUNNER_REQUEST) {
+    if (!requestPath) {
+        throw new Error('Fleet Slice runner request path is missing.');
+    }
+    return (0, slice_runner_js_1.runFleetSliceRunner)(requestPath);
+}
+if (require.main === module) {
+    void runFleetSliceRunnerDaemon()
+        .then((code) => {
+        process.exitCode = code;
+    })
+        .catch((error) => {
+        process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=fleet-slice-runner-daemon.js.map

package/src/local-dev/fleet-slice-runner-daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-slice-runner-daemon.js","sourceRoot":"","sources":["../../../../../packages/nx/src/local-dev/fleet-slice-runner-daemon.ts"],"names":[],"mappings":";;AAEA,8DAOC;AATD,uDAAwD;AAEjD,KAAK,UAAU,yBAAyB,CAC7C,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B;IAExD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,IAAA,qCAAmB,EAAC,WAAW,CAAC,CAAC;AAC1C,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,KAAK,yBAAyB,EAAE;SAC7B,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC1B,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAC9D,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/src/local-dev/fleet-startup.d.ts

@@ -0,0 +1,22 @@
+import type { FleetProcessIdentity } from './fleet-lock.js';
+import { type LocalDevContext } from './local-context.js';
+import { type PersonalStageResolution } from './personal-stage.js';
+import { type PrivateStateSecurity } from './private-state.js';
+export declare const FLEET_STARTUP_SCHEMA_VERSION: 1;
+export interface FleetStartupRequest {
+    appData: string;
+    context: LocalDevContext;
+    fleetId: string;
+    frameworkVersion: string;
+    gitCommonDirectory: string;
+    identity: PersonalStageResolution;
+    launcher: FleetProcessIdentity;
+    schemaVersion: typeof FLEET_STARTUP_SCHEMA_VERSION;
+    sessionGeneration: string;
+    sstMode: 'mono' | 'multiplexer';
+    workspaceName: string;
+    workspaceRealpath: string;
+}
+export declare function validateFleetStartupRequest(value: unknown): FleetStartupRequest;
+export declare function writeFleetStartupRequest(path: string, request: unknown, security?: PrivateStateSecurity): FleetStartupRequest;
+export declare function readFleetStartupRequest(path: string, security?: PrivateStateSecurity): FleetStartupRequest;

package/src/local-dev/fleet-startup.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FLEET_STARTUP_SCHEMA_VERSION = void 0;
+exports.validateFleetStartupRequest = validateFleetStartupRequest;
+exports.writeFleetStartupRequest = writeFleetStartupRequest;
+exports.readFleetStartupRequest = readFleetStartupRequest;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const contract_validation_js_1 = require("./contract-validation.js");
+const errors_js_1 = require("./errors.js");
+const local_context_js_1 = require("./local-context.js");
+const personal_stage_js_1 = require("./personal-stage.js");
+const private_state_js_1 = require("./private-state.js");
+exports.FLEET_STARTUP_SCHEMA_VERSION = 1;
+function startupError(message) {
+    throw new errors_js_1.LocalDevContractError('invalid-state', message);
+}
+function absolutePath(value, label) {
+    const path = (0, contract_validation_js_1.requireBoundedString)(value, label, { maximumLength: 4_096 });
+    if (!(0, node_path_1.isAbsolute)(path))
+        return startupError(`${label} must be absolute.`);
+    return path;
+}
+function launcherIdentity(value) {
+    (0, contract_validation_js_1.assertRecord)(value, 'Fleet startup launcher');
+    (0, contract_validation_js_1.assertExactProperties)(value, ['pid', 'processIdentity', 'startedAt'], [], 'Fleet startup launcher');
+    return {
+        pid: (0, contract_validation_js_1.requireInteger)(value.pid, 'Fleet startup launcher pid', 1, 2_147_483_647),
+        processIdentity: (0, contract_validation_js_1.requireBoundedString)(value.processIdentity, 'Fleet startup launcher processIdentity', {
+            maximumLength: 128,
+            pattern: contract_validation_js_1.LOCAL_DEV_TOKEN_PATTERN,
+        }),
+        startedAt: (0, contract_validation_js_1.requireIsoTimestamp)(value.startedAt, 'Fleet startup launcher startedAt'),
+    };
+}
+function validateFleetStartupRequest(value) {
+    (0, contract_validation_js_1.assertRecord)(value, 'Fleet startup request');
+    (0, contract_validation_js_1.assertExactProperties)(value, [
+        'appData',
+        'context',
+        'fleetId',
+        'frameworkVersion',
+        'gitCommonDirectory',
+        'identity',
+        'launcher',
+        'schemaVersion',
+        'sessionGeneration',
+        'sstMode',
+        'workspaceName',
+        'workspaceRealpath',
+    ], [], 'Fleet startup request');
+    if (value.schemaVersion !== exports.FLEET_STARTUP_SCHEMA_VERSION) {
+        return startupError(`Fleet startup schemaVersion must be ${exports.FLEET_STARTUP_SCHEMA_VERSION}.`);
+    }
+    if (value.sstMode !== 'mono' && value.sstMode !== 'multiplexer') {
+        return startupError('Fleet startup sstMode is invalid.');
+    }
+    (0, contract_validation_js_1.assertRecord)(value.identity, 'Fleet startup identity');
+    (0, contract_validation_js_1.assertExactProperties)(value.identity, ['identitySource', 'resolverVersion', 'stage'], [], 'Fleet startup identity');
+    if (value.identity.identitySource !== personal_stage_js_1.PERSONAL_STAGE_IDENTITY_SOURCE ||
+        value.identity.resolverVersion !== personal_stage_js_1.PERSONAL_STAGE_RESOLVER_VERSION ||
+        typeof value.identity.stage !== 'string' ||
+        !(0, personal_stage_js_1.isFrameworkPersonalStage)(value.identity.stage)) {
+        return startupError('Fleet startup personal-stage identity is invalid.');
+    }
+    return {
+        appData: absolutePath(value.appData, 'Fleet startup appData'),
+        context: (0, local_context_js_1.validateLocalDevContext)(value.context),
+        fleetId: (0, contract_validation_js_1.requireBoundedString)(value.fleetId, 'Fleet startup fleetId', {
+            maximumLength: 63,
+            pattern: /^[a-z0-9][a-z0-9-]{0,62}$/,
+        }),
+        frameworkVersion: (0, contract_validation_js_1.requireBoundedString)(value.frameworkVersion, 'Fleet startup frameworkVersion', { maximumLength: 128 }),
+        gitCommonDirectory: absolutePath(value.gitCommonDirectory, 'Fleet startup gitCommonDirectory'),
+        identity: {
+            identitySource: personal_stage_js_1.PERSONAL_STAGE_IDENTITY_SOURCE,
+            resolverVersion: personal_stage_js_1.PERSONAL_STAGE_RESOLVER_VERSION,
+            stage: value.identity.stage,
+        },
+        launcher: launcherIdentity(value.launcher),
+        schemaVersion: exports.FLEET_STARTUP_SCHEMA_VERSION,
+        sessionGeneration: (0, contract_validation_js_1.requireBoundedString)(value.sessionGeneration, 'Fleet startup sessionGeneration', {
+            maximumLength: 128,
+            pattern: /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/,
+        }),
+        sstMode: value.sstMode,
+        workspaceName: (0, contract_validation_js_1.requireBoundedString)(value.workspaceName, 'Fleet startup workspaceName', {
+            maximumLength: 128,
+            pattern: /^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/,
+        }),
+        workspaceRealpath: absolutePath(value.workspaceRealpath, 'Fleet startup workspaceRealpath'),
+    };
+}
+function writeFleetStartupRequest(path, request, security = {}) {
+    const validated = validateFleetStartupRequest(request);
+    if (!(0, private_state_js_1.createPrivateFileExclusive)(path, `${JSON.stringify(validated, null, 2)}\n`, security)) {
+        return startupError('A Fleet startup request already exists; prove it stale before replacement.');
+    }
+    return validated;
+}
+function readFleetStartupRequest(path, security = {}) {
+    if (!(0, node_fs_1.existsSync)(path)) {
+        return startupError('Fleet startup request is missing.');
+    }
+    try {
+        return validateFleetStartupRequest(JSON.parse((0, private_state_js_1.readPrivateFile)(path, security).toString('utf8')));
+    }
+    catch (error) {
+        if (error instanceof errors_js_1.LocalDevContractError)
+            throw error;
+        return startupError(`Fleet startup request is malformed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+//# sourceMappingURL=fleet-startup.js.map

package/src/local-dev/fleet-startup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-startup.js","sourceRoot":"","sources":["../../../../../packages/nx/src/local-dev/fleet-startup.ts"],"names":[],"mappings":"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"}

package/src/local-dev/fleet-state.d.ts

@@ -0,0 +1,62 @@
+import { type LocalDevFailureClassification } from './errors.js';
+import { FLEET_CONTROL_PROTOCOL_VERSION, type FleetMutationCommand } from './control-contract.js';
+import { type FleetProcessIdentity } from './fleet-lock.js';
+import { type PrivateStateSecurity } from './private-state.js';
+import type { FleetRouterSource } from './fleet-configuration.js';
+export declare const FLEET_STATE_SCHEMA_VERSION: 1;
+export declare const FLEET_STATE_FILE: "control-state.json";
+export declare const FLEET_ROUTE_STATES: readonly ["remote", "starting", "ready", "unavailable"];
+export declare const FLEET_CLEANUP_STATES: readonly ["not-declared", "pending", "succeeded", "failed"];
+export declare const FLEET_OPERATION_STATES: readonly ["accepted", "running", "succeeded", "failed"];
+export type FleetRouteState = (typeof FLEET_ROUTE_STATES)[number];
+export type FleetCleanupState = (typeof FLEET_CLEANUP_STATES)[number];
+export type FleetOperationState = (typeof FLEET_OPERATION_STATES)[number];
+export interface FleetSliceState {
+    adapterVersion: 1 | 2;
+    cleanup: FleetCleanupState;
+    lastTransitionAt: string;
+    logSequence: number;
+    name: string;
+    port: number;
+    restartAttempts: number;
+    routeState: FleetRouteState;
+    runnerGeneration?: string;
+    selected: boolean;
+}
+export interface FleetOperationStateRecord {
+    acceptedAt: string;
+    command: FleetMutationCommand;
+    completedAt?: string;
+    failureClassification?: LocalDevFailureClassification;
+    id: string;
+    idempotencyKey: string;
+    slices: string[];
+    state: FleetOperationState;
+}
+export interface FleetStateRecord {
+    configurationFingerprint: string;
+    contextDigest: string;
+    controlProtocolVersion: typeof FLEET_CONTROL_PROTOCOL_VERSION;
+    createdAt: string;
+    fleetId: string;
+    frameworkVersion: string;
+    gitCommonDirectory: string;
+    heartbeatAt: string;
+    identitySource: 'os-account';
+    nxVersion: string;
+    operations: FleetOperationStateRecord[];
+    origin: string;
+    resolvedStage: string;
+    routerOrigin: string;
+    routerSource: FleetRouterSource;
+    schemaVersion: typeof FLEET_STATE_SCHEMA_VERSION;
+    sessionGeneration: string;
+    slices: FleetSliceState[];
+    supervisor: FleetProcessIdentity;
+    workspaceRealpath: string;
+}
+export declare function validateFleetStateRecord(value: unknown): FleetStateRecord;
+export declare function transitionFleetSliceState(value: FleetSliceState, next: FleetRouteState, transitionedAt?: string): FleetSliceState;
+export declare function fleetStatePath(sessionDirectory: string): string;
+export declare function readFleetState(sessionDirectory: string, security?: PrivateStateSecurity): FleetStateRecord | undefined;
+export declare function writeFleetState(sessionDirectory: string, value: unknown, security?: PrivateStateSecurity): FleetStateRecord;