feat(ql3): establish 3.0 incubation baseline

2026-09-20 16:07:11 +08:00 · 2026-08-12 00:25:26 +08:00
parent 4bf92dcfeb
commit c699c32461
2817 changed files with 779642 additions and 653 deletions
@@ -0,0 +1,132 @@
+'use strict';
+
+const assert = require('node:assert/strict');
+const { test } = require('node:test');
+const {
+  WORKER_SESSION_HEARTBEAT_SCHEMA,
+  WORKER_SESSION_REGISTER_SCHEMA,
+  WORKER_SESSION_TRANSITION_SCHEMA,
+} = require('@qinglong/runtime-core/worker-session-transport');
+const {
+  WorkerIngressHttpsClient,
+  WorkerIngressHttpsClientError,
+} = require('../dist/remote-execution/transport/workerIngressHttpsClient');
+const {
+  WorkerSessionHttpsClient,
+} = require('../dist/session/workerSessionHttpsClient');
+
+const authority = {
+  workerId: 'edge-1',
+  sessionId: '018f5c64-9b9d-7f1a-8c2d-1234567890ac',
+};
+const capabilitiesJson = '{}';
+const capabilitiesHash =
+  '44136fa355b3678a1146ad16f7e8649e94fb4fc21fe77e8310c060f61caaff8a';
+
+function client(exchange) {
+  const transport = new WorkerIngressHttpsClient({
+    origin: 'https://worker-control.invalid',
+    credentials: { async load() { throw new Error('not reached'); } },
+  });
+  transport.postJson = exchange;
+  return new WorkerSessionHttpsClient({ client: transport });
+}
+
+test('registers one exact path-bound Session over the shared client', async () => {
+  let observed;
+  const session = client(async (request) => {
+    observed = request;
+    return Buffer.from(JSON.stringify({
+      schema: WORKER_SESSION_REGISTER_SCHEMA,
+      ...authority,
+      generation: 1,
+      version: 0,
+      status: 'online',
+      leaseExpiresAtMs: 50_000,
+      replacedSession: false,
+    }));
+  });
+  const result = await session.register({
+    ...authority,
+    capabilitiesJson,
+    capabilitiesHash,
+    maxConcurrentRuns: 2,
+    availableSlots: 1,
+    leaseDurationMs: 30_000,
+  });
+  assert.equal(result.status, 'online');
+  assert.match(observed.path, /\/register$/);
+  assert.equal(observed.body.schema, WORKER_SESSION_REGISTER_SCHEMA);
+  assert.equal('workerId' in observed.body, false);
+  assert.equal(observed.maximumRequestBytes, 20 * 1024);
+});
+
+test('heartbeats and transitions under exact next-version fences', async () => {
+  const operations = [];
+  const session = client(async (request) => {
+    operations.push(request.body.schema);
+    const transition = request.body.schema === WORKER_SESSION_TRANSITION_SCHEMA;
+    return Buffer.from(JSON.stringify({
+      schema: request.body.schema,
+      ...authority,
+      generation: 2,
+      version: request.body.expectedVersion + 1,
+      status: transition ? request.body.status : 'online',
+      leaseExpiresAtMs: 60_000,
+    }));
+  });
+  const heartbeat = await session.heartbeat({
+    ...authority, generation: 2, expectedVersion: 3,
+    availableSlots: 1, leaseDurationMs: 30_000,
+  });
+  assert.equal(heartbeat.version, 4);
+  const drained = await session.transition({
+    ...authority, generation: 2, expectedVersion: 4, status: 'draining',
+  });
+  assert.equal(drained.status, 'draining');
+  assert.deepEqual(operations, [
+    WORKER_SESSION_HEARTBEAT_SCHEMA,
+    WORKER_SESSION_TRANSITION_SCHEMA,
+  ]);
+});
+
+test('rejects response authority and version drift', async () => {
+  const session = client(async () => Buffer.from(JSON.stringify({
+    schema: WORKER_SESSION_HEARTBEAT_SCHEMA,
+    ...authority,
+    generation: 2,
+    version: 99,
+    status: 'online',
+    leaseExpiresAtMs: 60_000,
+  })));
+  await assert.rejects(
+    session.heartbeat({
+      ...authority, generation: 2, expectedVersion: 3,
+      availableSlots: 1, leaseDurationMs: 30_000,
+    }),
+    /response_invalid/,
+  );
+});
+
+test('classifies credential rejection and Session fencing without error bodies', async () => {
+  for (const [statusCode, reason] of [
+    [401, 'credential_rejected'],
+    [403, 'credential_rejected'],
+    [409, 'session_fenced'],
+    [503, 'transport_unavailable'],
+  ]) {
+    const session = client(async () => {
+      throw new WorkerIngressHttpsClientError(
+        'response_rejected',
+        statusCode,
+      );
+    });
+    await assert.rejects(
+      session.heartbeat({
+        ...authority, generation: 2, expectedVersion: 3,
+        availableSlots: 1, leaseDurationMs: 30_000,
+      }),
+      (error) => error.reason === reason,
+    );
+  }
+});