@sasjs/api 0.10.0 → 0.12.0

package/build/cjs/corpus/code.js

@@ -38,13 +38,50 @@ exports.CODE_CORPUS = [
             ]
         }
     },
-    // Two refusals are deliberately not pinned here yet: a `code` that is not a
-    // string, and one that is empty. The package answers 400 `"code" must be a
-    // string` / `"code" is not allowed to be empty` - the messages the server's
-    // schema produces - but sasjs/server's code controller carries no
-    // `@Response(400)` for these routes, so the document states 200 alone and the
-    // parity gate refuses a case answering anything else. The cases land when the
-    // decorators do.
+    {
+        id: 'code-lint-unauthenticated',
+        route: 'POST /SASjsApi/code/lint',
+        description: 'refuses a caller with no token',
+        request: { body: { code: 'data _null_; run;' } },
+        expect: { status: 401, error: 'Unauthorized' }
+    },
+    {
+        id: 'code-lint-non-string',
+        route: 'POST /SASjsApi/code/lint',
+        description: 'refuses a code value that is not a string, rather than coercing it',
+        request: {
+            subject: { userId: 'user-admin', clientId: 'web_app' },
+            body: { code: 123 }
+        },
+        expect: { status: 400, error: '"code" must be a string' }
+    },
+    {
+        id: 'code-lint-empty',
+        route: 'POST /SASjsApi/code/lint',
+        description: 'refuses an empty buffer, which is not the same as a missing one',
+        request: {
+            subject: { userId: 'user-admin', clientId: 'web_app' },
+            body: { code: '' }
+        },
+        expect: { status: 400, error: '"code" is not allowed to be empty' }
+    },
+    {
+        id: 'code-format-unauthenticated',
+        route: 'POST /SASjsApi/code/format',
+        description: 'refuses a caller with no token',
+        request: { body: { code: 'data _null_; run;' } },
+        expect: { status: 401, error: 'Unauthorized' }
+    },
+    {
+        id: 'code-format-non-string',
+        route: 'POST /SASjsApi/code/format',
+        description: 'refuses a code value that is not a string',
+        request: {
+            subject: { userId: 'user-admin', clientId: 'web_app' },
+            body: { code: 123 }
+        },
+        expect: { status: 400, error: '"code" must be a string' }
+    },
     {
         id: 'code-format-adds-the-header',
         route: 'POST /SASjsApi/code/format',

package/build/cjs/corpus/deploy.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEPLOY_CORPUS = void 0;
+const SUBJECT = { userId: 'user-admin', clientId: 'web_app' };
+exports.DEPLOY_CORPUS = [
+    {
+        id: 'deploy-unpublish',
+        route: 'DELETE /SASjsApi/drive/deploy',
+        description: 'removes a published app stream and answers the status',
+        request: {
+            subject: SUBJECT,
+            body: { streamServiceName: 'myApp', appLoc: '/Public/myApp' }
+        },
+        expect: { status: 200, body: { status: 'success' } }
+    },
+    {
+        id: 'deploy-unpublish-other-name',
+        route: 'DELETE /SASjsApi/drive/deploy',
+        description: 'removes the app by its folder when the name has been renamed',
+        request: {
+            subject: SUBJECT,
+            body: { streamServiceName: 'renamed-app', appLoc: '/Public/myApp' }
+        },
+        expect: { status: 200, body: { status: 'success' } }
+    },
+    {
+        id: 'deploy-unpublish-no-stream-name',
+        route: 'DELETE /SASjsApi/drive/deploy',
+        description: 'refuses a body that does not say which stream to remove',
+        request: { subject: SUBJECT, body: { appLoc: '/Public/myApp' } },
+        expect: { status: 400, error: '"streamServiceName" is required' }
+    },
+    {
+        id: 'deploy-unpublish-no-app-loc',
+        route: 'DELETE /SASjsApi/drive/deploy',
+        description: 'refuses a body that does not say which folder to remove',
+        request: { subject: SUBJECT, body: { streamServiceName: 'myApp' } },
+        expect: { status: 400, error: '"appLoc" is required' }
+    },
+    {
+        id: 'deploy-unpublish-unknown-folder',
+        route: 'DELETE /SASjsApi/drive/deploy',
+        description: 'answers 404 for a folder nothing is published at',
+        request: {
+            subject: SUBJECT,
+            body: { streamServiceName: 'myApp', appLoc: '/Public/not-an-app' }
+        },
+        expect: { status: 404, error: 'No such app stream entry.' }
+    }
+];

package/build/cjs/corpus/runner.js

@@ -4,8 +4,11 @@ exports.runCase = exports.servicesFor = void 0;
 const dispatch_js_1 = require("../host/dispatch.js");
 const service_js_1 = require("../drive/service.js");
 const memory_store_js_1 = require("../drive/memory-store.js");
+const registry_js_1 = require("../drive/registry.js");
 const service_js_2 = require("../identity/service.js");
 const records_js_1 = require("../identity/records.js");
+const service_js_3 = require("../session/service.js");
+const memory_host_js_1 = require("../session/memory-host.js");
 const memory_store_js_2 = require("../identity/memory-store.js");
 const fixture_js_1 = require("../identity/fixture.js");
 const types_js_1 = require("../types.js");
@@ -26,7 +29,9 @@ const servicesFor = (testCase) => {
             ? new RefusingDriveStore(testCase.seed || {})
             : new memory_store_js_1.MemoryDriveStore(testCase.seed || {})),
         identity: (0, service_js_2.createIdentityService)(identity),
-        records: (0, records_js_1.createRecordService)(identity)
+        records: (0, records_js_1.createRecordService)(identity),
+        registry: new registry_js_1.MemoryAppStreamRegistry(),
+        session: (0, service_js_3.createSessionService)(identity, new memory_host_js_1.MemorySessionHost())
     };
 };
 exports.servicesFor = servicesFor;

package/build/cjs/corpus/session.js

@@ -0,0 +1,142 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESSION_CORPUS = void 0;
+const ADMIN = { userId: 'user-admin', clientId: 'web_app' };
+const RESTRICTED = { userId: 'user-restricted', clientId: 'web_app' };
+const notFound = (id) => `Session with ID '${id}' was not found.`;
+const UNAUTHORIZED = 'Unauthorized';
+exports.SESSION_CORPUS = [
+    // ---------------------------------------------------------------- summary
+    {
+        id: 'session-summary-own',
+        route: 'GET /SASjsApi/session/{sessionId}',
+        description: 'answers the owner the summary of their own session',
+        request: { subject: ADMIN, params: { sessionId: 'sess-admin' } },
+        expect: {
+            status: 200,
+            body: {
+                sessionId: 'sess-admin',
+                state: 'completed',
+                pid: 4242,
+                creationTimeStamp: '2026-11-07T09:00:00.000Z',
+                deathTimeStamp: '2026-11-07T09:00:04.000Z',
+                expiresAfterMins: 60
+            }
+        }
+    },
+    {
+        id: 'session-summary-as-admin',
+        route: 'GET /SASjsApi/session/{sessionId}',
+        description: "answers an administrator another account's session",
+        request: { subject: ADMIN, params: { sessionId: 'sess-restricted' } },
+        expect: {
+            status: 200,
+            body: {
+                sessionId: 'sess-restricted',
+                state: 'running',
+                pid: 4243,
+                creationTimeStamp: '2026-11-07T09:05:00.000Z'
+            }
+        }
+    },
+    {
+        id: 'session-summary-unauthenticated',
+        route: 'GET /SASjsApi/session/{sessionId}',
+        description: 'refuses a caller with no token',
+        request: { params: { sessionId: 'sess-admin' } },
+        expect: { status: 401, error: UNAUTHORIZED }
+    },
+    {
+        id: 'session-summary-foreign',
+        route: 'GET /SASjsApi/session/{sessionId}',
+        description: "answers 404 for another account's session, not 403",
+        request: { subject: RESTRICTED, params: { sessionId: 'sess-admin' } },
+        expect: { status: 404, error: notFound('sess-admin') }
+    },
+    {
+        id: 'session-summary-unknown',
+        route: 'GET /SASjsApi/session/{sessionId}',
+        description: 'answers the same 404 for a session that does not exist',
+        request: { subject: ADMIN, params: { sessionId: 'sess-nope' } },
+        expect: { status: 404, error: notFound('sess-nope') }
+    },
+    // -------------------------------------------------------------------- log
+    {
+        id: 'session-log-own',
+        route: 'GET /SASjsApi/session/{sessionId}/log',
+        description: 'answers the log this session wrote',
+        request: { subject: ADMIN, params: { sessionId: 'sess-admin' } },
+        expect: {
+            status: 200,
+            contents: 'NOTE: session started\nNOTE: session completed\n'
+        }
+    },
+    {
+        id: 'session-log-nothing-written',
+        route: 'GET /SASjsApi/session/{sessionId}/log',
+        description: 'answers an empty body for a session that has written nothing',
+        request: { subject: ADMIN, params: { sessionId: 'sess-silent' } },
+        expect: { status: 200, contents: '' }
+    },
+    {
+        id: 'session-log-unauthenticated',
+        route: 'GET /SASjsApi/session/{sessionId}/log',
+        description: 'refuses a caller with no token',
+        request: { params: { sessionId: 'sess-admin' } },
+        expect: { status: 401, error: UNAUTHORIZED }
+    },
+    {
+        id: 'session-log-foreign',
+        route: 'GET /SASjsApi/session/{sessionId}/log',
+        description: "will not read another account's log",
+        request: { subject: RESTRICTED, params: { sessionId: 'sess-admin' } },
+        expect: { status: 404, error: notFound('sess-admin') }
+    },
+    // ----------------------------------------------------------------- output
+    {
+        id: 'session-output-own',
+        route: 'GET /SASjsApi/session/{sessionId}/output',
+        description: 'answers the webout this session produced',
+        request: { subject: ADMIN, params: { sessionId: 'sess-admin' } },
+        expect: { status: 200, contents: '<html><body>42</body></html>' }
+    },
+    {
+        id: 'session-output-unauthenticated',
+        route: 'GET /SASjsApi/session/{sessionId}/output',
+        description: 'refuses a caller with no token',
+        request: { params: { sessionId: 'sess-admin' } },
+        expect: { status: 401, error: UNAUTHORIZED }
+    },
+    {
+        id: 'session-output-foreign',
+        route: 'GET /SASjsApi/session/{sessionId}/output',
+        description: "will not read another account's webout",
+        request: { subject: RESTRICTED, params: { sessionId: 'sess-admin' } },
+        expect: { status: 404, error: notFound('sess-admin') }
+    },
+    // ------------------------------------------------------------------ state
+    {
+        id: 'session-state-own',
+        route: 'GET /SASjsApi/session/{sessionId}/state',
+        description: "answers the run time's state for this session",
+        request: { subject: RESTRICTED, params: { sessionId: 'sess-restricted' } },
+        expect: {
+            status: 200,
+            body: { state: 'running', pid: 4243, lineCount: 3 }
+        }
+    },
+    {
+        id: 'session-state-unauthenticated',
+        route: 'GET /SASjsApi/session/{sessionId}/state',
+        description: 'refuses a caller with no token',
+        request: { params: { sessionId: 'sess-restricted' } },
+        expect: { status: 401, error: UNAUTHORIZED }
+    },
+    {
+        id: 'session-state-foreign',
+        route: 'GET /SASjsApi/session/{sessionId}/state',
+        description: "will not report another account's session state",
+        request: { subject: RESTRICTED, params: { sessionId: 'sess-admin' } },
+        expect: { status: 404, error: notFound('sess-admin') }
+    }
+];

package/build/cjs/drive/registry.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryAppStreamRegistry = exports.unpublishAppStream = void 0;
+const types_js_1 = require("../types.js");
+/**
+ * `DELETE /SASjsApi/drive/deploy`.
+ *
+ * The document requires both body values, so both are checked - a caller that
+ * names a stream but not the folder has not said what to remove. Only the folder
+ * reaches the registry, because that is what identifies the app.
+ *
+ * The checks are here rather than in the transport because this is the one
+ * implementation of the operation: a host calling it directly gets the same
+ * refusals in the same order, and with the same messages the document states.
+ */
+const unpublishAppStream = async (registry, body) => {
+    if (!body?.streamServiceName)
+        throw new types_js_1.ApiError(400, '"streamServiceName" is required');
+    if (!body.appLoc)
+        throw new types_js_1.ApiError(400, '"appLoc" is required');
+    if (!(await registry.unpublish(body.appLoc)))
+        throw new types_js_1.ApiError(404, 'No such app stream entry.');
+    return { status: 'success' };
+};
+exports.unpublishAppStream = unpublishAppStream;
+/**
+ * The registry the corpus and the package's own tests read: one published app,
+ * identified by its folder alone.
+ */
+class MemoryAppStreamRegistry {
+    constructor(folders = ['/Public/myApp']) {
+        this.folders = new Set(folders);
+    }
+    async unpublish(appLoc) {
+        return this.folders.delete(appLoc);
+    }
+}
+exports.MemoryAppStreamRegistry = MemoryAppStreamRegistry;

package/build/cjs/host/dispatch.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HANDLED_ROUTES = exports.dispatch = void 0;
 const index_js_1 = require("../routes/index.js");
+const registry_js_1 = require("../drive/registry.js");
 const types_js_1 = require("../types.js");
 const deploy_js_1 = require("../drive/deploy.js");
 /** The defaults sasjs/server's Client schema applies to an omitted lifetime. */
@@ -74,6 +75,12 @@ const dispatch = async (services, routeId, request = {}) => {
     const body = request.body || {};
     const params = request.params || {};
     /** The record service, or the 501 a host without one answers. */
+    /** The host's sessions, or the 501 that names the missing capability. */
+    const sessionRequired = () => {
+        if (!services.session)
+            throw new types_js_1.ApiError(501, `This host has no session service, so it cannot answer ${routeId}.`);
+        return services.session;
+    };
     const required = () => {
         if (!records)
             throw new types_js_1.ApiError(501, `This host has no record service, so it cannot answer ${routeId}.`);
@@ -169,8 +176,40 @@ const dispatch = async (services, routeId, request = {}) => {
             await drive.deploy(String(body.appLoc ?? ''), body.fileTree);
             return { status: 200, body: deploy_js_1.DEPLOY_SUCCESS };
         }
+        case 'DELETE /SASjsApi/drive/deploy':
+            if (!services.registry)
+                throw new types_js_1.ApiError(501, `This host has no app stream registry, so it cannot answer ${routeId}.`);
+            return {
+                status: 200,
+                body: await (0, registry_js_1.unpublishAppStream)(services.registry, body)
+            };
         case 'GET /SASjsApi/drive/filetree':
             return { status: 200, body: await drive.tree(query._folderPath) };
+        // ------------------------------------------------------------- sessions
+        case 'GET /SASjsApi/session/{sessionId}': {
+            return {
+                status: 200,
+                body: await sessionRequired().summary(await caller(), String(params.sessionId ?? ''))
+            };
+        }
+        case 'GET /SASjsApi/session/{sessionId}/log': {
+            return {
+                status: 200,
+                contents: await sessionRequired().log(await caller(), String(params.sessionId ?? ''))
+            };
+        }
+        case 'GET /SASjsApi/session/{sessionId}/output': {
+            return {
+                status: 200,
+                contents: await sessionRequired().output(await caller(), String(params.sessionId ?? ''))
+            };
+        }
+        case 'GET /SASjsApi/session/{sessionId}/state': {
+            return {
+                status: 200,
+                body: await sessionRequired().state(await caller(), String(params.sessionId ?? ''))
+            };
+        }
         // ------------------------------------------------------------- records
         //
         // The administration routes: users, groups, permission rules, clients and the
@@ -357,6 +396,11 @@ const dispatch = async (services, routeId, request = {}) => {
 exports.dispatch = dispatch;
 /** Whether a route is one `dispatch` can answer today. */
 exports.HANDLED_ROUTES = [
+    'DELETE /SASjsApi/drive/deploy',
+    'GET /SASjsApi/session/{sessionId}',
+    'GET /SASjsApi/session/{sessionId}/log',
+    'GET /SASjsApi/session/{sessionId}/output',
+    'GET /SASjsApi/session/{sessionId}/state',
     'POST /SASjsApi/code/lint',
     'POST /SASjsApi/code/format',
     'GET /SASjsApi/info/authorizedRoutes',

package/build/cjs/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.servicesFor = exports.runCase = exports.PROVIDER_MANAGED = exports.ADMIN_SIGNED_IN = exports.RECORD_CORPUS = exports.IDENTITY_CORPUS = exports.DRIVE_CORPUS = exports.parseIdentity = exports.IDENTITY_FORMAT = exports.DEFAULT_IDENTITY = exports.MemoryIdentityStore = exports.CODE_CORPUS = exports.sanitiseDisplayName = exports.createRecordService = exports.createIdentityService = exports.HANDLED_ROUTES = exports.dispatch = exports.TAG_CAPABILITIES = exports.OVERLAY = exports.findRoute = exports.routeById = exports.ROUTES = exports.MemoryDriveStore = exports.measureDeployTree = exports.isDeployTree = exports.deployTree = exports.decodeBase64 = exports.checkDeployTree = exports.DEPLOY_SUCCESS = exports.DEPLOY_PAYLOAD_BYTES = exports.DEPLOY_LIMITS = exports.createDriveService = exports.isRoot = exports.basename = exports.dirname = exports.hasBlockedExtension = exports.normaliseDrivePath = void 0;
+exports.servicesFor = exports.runCase = exports.PROVIDER_MANAGED = exports.ADMIN_SIGNED_IN = exports.RECORD_CORPUS = exports.SESSION_CORPUS = exports.DEPLOY_CORPUS = exports.IDENTITY_CORPUS = exports.DRIVE_CORPUS = exports.parseIdentity = exports.IDENTITY_FORMAT = exports.DEFAULT_IDENTITY = exports.MemoryIdentityStore = exports.CODE_CORPUS = exports.sanitiseDisplayName = exports.createRecordService = exports.createIdentityService = exports.HANDLED_ROUTES = exports.dispatch = exports.TAG_CAPABILITIES = exports.OVERLAY = exports.findRoute = exports.routeById = exports.ROUTES = exports.MemoryDriveStore = exports.measureDeployTree = exports.isDeployTree = exports.deployTree = exports.decodeBase64 = exports.checkDeployTree = exports.DEPLOY_SUCCESS = exports.DEPLOY_PAYLOAD_BYTES = exports.DEPLOY_LIMITS = exports.createDriveService = exports.isRoot = exports.basename = exports.dirname = exports.hasBlockedExtension = exports.normaliseDrivePath = void 0;
 /**
  * `@sasjs/api` - the SASjs Server API described once.
  *
@@ -79,6 +79,10 @@ var drive_js_1 = require("./corpus/drive.js");
 Object.defineProperty(exports, "DRIVE_CORPUS", { enumerable: true, get: function () { return drive_js_1.DRIVE_CORPUS; } });
 var identity_js_1 = require("./corpus/identity.js");
 Object.defineProperty(exports, "IDENTITY_CORPUS", { enumerable: true, get: function () { return identity_js_1.IDENTITY_CORPUS; } });
+var deploy_js_2 = require("./corpus/deploy.js");
+Object.defineProperty(exports, "DEPLOY_CORPUS", { enumerable: true, get: function () { return deploy_js_2.DEPLOY_CORPUS; } });
+var session_js_1 = require("./corpus/session.js");
+Object.defineProperty(exports, "SESSION_CORPUS", { enumerable: true, get: function () { return session_js_1.SESSION_CORPUS; } });
 var records_js_2 = require("./corpus/records.js");
 Object.defineProperty(exports, "RECORD_CORPUS", { enumerable: true, get: function () { return records_js_2.RECORD_CORPUS; } });
 Object.defineProperty(exports, "ADMIN_SIGNED_IN", { enumerable: true, get: function () { return records_js_2.ADMIN_SIGNED_IN; } });

package/build/cjs/routes/generated.js

@@ -347,6 +347,14 @@ exports.GENERATED_ROUTES = [
             {
                 status: 200,
                 description: 'Ok'
+            },
+            {
+                status: 400,
+                description: '"code" is required / "code" must be a string / "code" is not allowed to be empty'
+            },
+            {
+                status: 401,
+                description: 'Unauthorized'
             }
         ]
     },
@@ -375,6 +383,14 @@ exports.GENERATED_ROUTES = [
             {
                 status: 200,
                 description: 'Ok'
+            },
+            {
+                status: 400,
+                description: '"code" is required / "code" must be a string / "code" is not allowed to be empty'
+            },
+            {
+                status: 401,
+                description: 'Unauthorized'
             }
         ]
     },
@@ -1285,6 +1301,14 @@ exports.GENERATED_ROUTES = [
             {
                 status: 200,
                 description: 'Ok'
+            },
+            {
+                status: 401,
+                description: 'No valid access token or session was supplied'
+            },
+            {
+                status: 404,
+                description: 'Session with the given ID was not found.'
             }
         ]
     },
@@ -1307,6 +1331,14 @@ exports.GENERATED_ROUTES = [
             {
                 status: 200,
                 description: 'Ok'
+            },
+            {
+                status: 401,
+                description: 'No valid access token or session was supplied'
+            },
+            {
+                status: 404,
+                description: 'Session with the given ID was not found.'
             }
         ]
     },
@@ -1329,6 +1361,14 @@ exports.GENERATED_ROUTES = [
             {
                 status: 200,
                 description: 'Ok'
+            },
+            {
+                status: 401,
+                description: 'No valid access token or session was supplied'
+            },
+            {
+                status: 404,
+                description: 'Session with the given ID was not found.'
             }
         ]
     },
@@ -1351,6 +1391,14 @@ exports.GENERATED_ROUTES = [
             {
                 status: 200,
                 description: 'Ok'
+            },
+            {
+                status: 401,
+                description: 'No valid access token or session was supplied'
+            },
+            {
+                status: 404,
+                description: 'Session with the given ID was not found.'
             }
         ]
     },

package/build/cjs/routes/overlay.js

@@ -27,12 +27,10 @@ exports.TAG_CAPABILITIES = {
  */
 const DIRECTORY = 'Synchronising with an external auth provider needs a directory port, which this package does not have: a host decides which directory it holds accounts in, and answers this itself.';
 const RUNTIME = 'Starting a program needs a runtime port, which this package does not have: a host decides which languages it holds, and answers this itself until then.';
-const SESSION_RECORD = "A triggered session's record, log, output and state belong to the runtime that ran the program, and this package has no runtime port.";
 const HOST_CONFIG = "The body is the host's own configuration - ports, run times and providers - which a mock states for itself and this package cannot know.";
 const HOST_OWNED = "The host owns this report: it describes the host's own process and files, which a browser build has no equivalent of.";
 const WEB_BUNDLE = 'The host serves its own web bundle; there is no API decision here for this package to answer.';
 const ARCHIVE = "Expanding the uploaded archive is the host's transport work - multer and a zip library on the server, `DecompressionStream` in a worker - and the host hands this package the tree it produces, which is the same tree `POST /SASjsApi/drive/deploy` takes.";
-const UNPUBLISH = 'Unpublishing inverts the deploy route, so the two land together.';
 const success = { status: 'success' };
 const user = {
     uid: '',
@@ -166,10 +164,7 @@ exports.OVERLAY = {
     },
     // `404` is a pair - the registry name and the appLoc it was published from -
     // that matches no entry, and the drive's content is deliberately left alone.
-    'DELETE /SASjsApi/drive/deploy': {
-        implemented: false,
-        reason: UNPUBLISH
-    },
+    'DELETE /SASjsApi/drive/deploy': { implemented: true },
     // Group - members and the groups themselves
     'GET /SASjsApi/group': { implemented: true },
     'GET /SASjsApi/group/{uid}': { implemented: true },
@@ -205,22 +200,13 @@ exports.OVERLAY = {
         implemented: true,
         responses: { 200: user }
     },
-    'GET /SASjsApi/session/{sessionId}': {
-        implemented: false,
-        reason: SESSION_RECORD
-    },
-    'GET /SASjsApi/session/{sessionId}/log': {
-        implemented: false,
-        reason: SESSION_RECORD
-    },
-    'GET /SASjsApi/session/{sessionId}/output': {
-        implemented: false,
-        reason: SESSION_RECORD
-    },
-    'GET /SASjsApi/session/{sessionId}/state': {
-        implemented: false,
-        reason: SESSION_RECORD
-    },
+    // The port takes the owner as a uid and falls back to a username, which is
+    // what sasjs/server records today - a host hands its sessions through as they
+    // are, and the comparison tries the identifier first.
+    'GET /SASjsApi/session/{sessionId}': { implemented: true },
+    'GET /SASjsApi/session/{sessionId}/log': { implemented: true },
+    'GET /SASjsApi/session/{sessionId}/output': { implemented: true },
+    'GET /SASjsApi/session/{sessionId}/state': { implemented: true },
     // STP - a stored program, on the runtime port
     'GET /SASjsApi/stp/execute': { implemented: false, reason: RUNTIME },
     'POST /SASjsApi/stp/execute': { implemented: false, reason: RUNTIME },

package/build/cjs/session/memory-host.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemorySessionHost = exports.DEFAULT_SESSIONS = void 0;
+/**
+ * The sessions the corpus and the package's own tests read.
+ *
+ * One session per account, so the interesting case is expressible: an
+ * administrator may read a session that is not theirs, and the other way round
+ * answers the 404 that hides it. `sess-silent` exists with nothing written yet,
+ * because an empty log is a 200 and not a 404.
+ */
+exports.DEFAULT_SESSIONS = {
+    'sess-admin': {
+        owner: 'user-admin',
+        summary: {
+            sessionId: 'sess-admin',
+            state: 'completed',
+            pid: 4242,
+            creationTimeStamp: '2026-11-07T09:00:00.000Z',
+            deathTimeStamp: '2026-11-07T09:00:04.000Z',
+            expiresAfterMins: 60
+        }
+    },
+    'sess-restricted': {
+        owner: 'user-restricted',
+        summary: {
+            sessionId: 'sess-restricted',
+            state: 'running',
+            pid: 4243,
+            creationTimeStamp: '2026-11-07T09:05:00.000Z'
+        }
+    },
+    'sess-silent': {
+        owner: 'user-admin',
+        summary: {
+            sessionId: 'sess-silent',
+            state: 'running',
+            pid: 4244,
+            creationTimeStamp: '2026-11-07T09:10:00.000Z'
+        }
+    }
+};
+const STATES = {
+    'sess-admin': { state: 'completed', pid: 4242, lineCount: 12 },
+    'sess-restricted': { state: 'running', pid: 4243, lineCount: 3 }
+};
+const LOGS = {
+    'sess-admin': 'NOTE: session started\nNOTE: session completed\n',
+    'sess-restricted': 'NOTE: session started\n',
+    'sess-silent': ''
+};
+const OUTPUTS = {
+    'sess-admin': '<html><body>42</body></html>',
+    'sess-restricted': '',
+    'sess-silent': ''
+};
+class MemorySessionHost {
+    constructor(sessions = exports.DEFAULT_SESSIONS) {
+        this.sessions = sessions;
+    }
+    async session(id) {
+        return this.sessions[id];
+    }
+    async state(id) {
+        return STATES[id];
+    }
+    async log(id) {
+        return LOGS[id];
+    }
+    async output(id) {
+        return OUTPUTS[id];
+    }
+}
+exports.MemorySessionHost = MemorySessionHost;