@sasjs/api 0.9.0 → 0.11.0

package/build/cjs/code/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCodeService = void 0;
+/**
+ * The code service, on its own entry point.
+ *
+ * `@sasjs/lint` reads the filesystem (its config resolution walks up for a
+ * `.sasjslint`), so it cannot be bundled for a service worker: the package root
+ * stays free of it and a host that wants these routes imports `@sasjs/api/code`.
+ */
+var service_js_1 = require("./service.js");
+Object.defineProperty(exports, "createCodeService", { enumerable: true, get: function () { return service_js_1.createCodeService; } });

package/build/cjs/code/service.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCodeService = void 0;
+const lint_1 = require("@sasjs/lint");
+const types_js_1 = require("../types.js");
+/**
+ * `code`, refused the way the server's schema refuses it.
+ *
+ * Coercing with `String(...)` defeated the refusal: `{"code": 123}` was linted as
+ * the text "123" and `{"code": ""}` answered "required" where the server says it
+ * is empty. The three messages are Joi's, because they are the ones a client
+ * written against the document already handles.
+ */
+const codeOf = (body) => {
+    const value = body.code;
+    if (value === undefined)
+        throw new types_js_1.ApiError(400, '"code" is required');
+    if (typeof value !== 'string')
+        throw new types_js_1.ApiError(400, '"code" must be a string');
+    if (value === '')
+        throw new types_js_1.ApiError(400, '"code" is not allowed to be empty');
+    return value;
+};
+/**
+ * The two editor routes, over `@sasjs/lint`.
+ *
+ * The linter is a dependency because it is the same everywhere, and it is
+ * deliberately NOT reachable from the package root: `@sasjs/lint` resolves its
+ * configuration by walking the filesystem, so it cannot be bundled into the
+ * service worker the browser entry produces. A host that wants these routes
+ * imports `@sasjs/api/code`, which is Node-only, exactly like the linter.
+ *
+ * The *rules* are the host's: which `.sasjslint` applies to a path is a fact
+ * about a drive, so `lintConfig` is asked for it.
+ * Neither route touches the drive or runs anything; they answer about the text
+ * in the request, which is what lets an editor check unsaved changes.
+ */
+const createCodeService = (options = {}) => {
+    const requireCaller = (caller) => {
+        // both routes are permissioned at the gate, so a caller that reached the
+        // service without one is a host that skipped it rather than a public route
+        if (!caller)
+            throw new types_js_1.ApiError(401, 'Unauthorized');
+    };
+    const configFor = (filePath) => options.lintConfig ? options.lintConfig(filePath) : undefined;
+    return {
+        async lint(caller, body) {
+            requireCaller(caller);
+            return (0, lint_1.lintText)(codeOf(body), configFor(body.filePath));
+        },
+        async format(caller, body) {
+            requireCaller(caller);
+            return (0, lint_1.formatText)(codeOf(body), configFor(body.filePath));
+        }
+    };
+};
+exports.createCodeService = createCodeService;

package/build/cjs/corpus/code.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CODE_CORPUS = void 0;
+/**
+ * The editor's corpus: the two routes that answer about a buffer rather than a
+ * file.
+ *
+ * Both expectations are the linter's own output for the same input, measured
+ * against `@sasjs/lint` with no configuration - the defaults an untitled buffer
+ * lints against. A host that supplies a `.sasjslint` changes the rules for its
+ * own drive, which is why the case names no `filePath`.
+ *
+ *     lintText('data _null_;\n  x = 1;\nrun;\n')
+ *       -> [{ message: 'File missing Doxygen header', lineNumber: 1, ... }]
+ *     formatText(...)
+ *       -> the header block, then the program with its spacing normalised
+ */
+exports.CODE_CORPUS = [
+    {
+        id: 'code-lint-missing-header',
+        route: 'POST /SASjsApi/code/lint',
+        description: 'answers the diagnostics for a buffer, without touching a file',
+        request: {
+            // the routes are permissioned; the runner resolves the fixture's admin
+            subject: { userId: 'user-admin', clientId: 'web_app' },
+            body: { code: 'data _null_;\n  x = 1;\nrun;\n' }
+        },
+        expect: {
+            status: 200,
+            body: [
+                {
+                    message: 'File missing Doxygen header',
+                    lineNumber: 1,
+                    startColumnNumber: 1,
+                    endColumnNumber: 1,
+                    severity: 1
+                }
+            ]
+        }
+    },
+    {
+        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',
+        description: 'answers the formatted buffer, header block included',
+        request: {
+            // the routes are permissioned; the runner resolves the fixture's admin
+            subject: { userId: 'user-admin', clientId: 'web_app' },
+            body: { code: 'data _null_;\n  x = 1;\nrun;\n' }
+        },
+        expect: {
+            status: 200,
+            body: '/**\n  @file\n  @brief <Your brief here>\n\n  <h4> SAS Macros </h4>\n\n**/\ndata _null_;\n  x = 1;\nrun;\n'
+        }
+    }
+];

package/build/cjs/corpus/runner.js

@@ -6,6 +6,8 @@ const service_js_1 = require("../drive/service.js");
 const memory_store_js_1 = require("../drive/memory-store.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 +28,8 @@ 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),
+        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,73 @@
+"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' };
+exports.SESSION_CORPUS = [
+    {
+        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-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-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-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 }
+        }
+    }
+];

package/build/cjs/host/dispatch.js

@@ -24,8 +24,13 @@ const validate = (route, request) => {
         const given = param.in === 'query'
             ? request.query?.[param.name]
             : request.body?.[param.name];
-        if (given === undefined || given === '')
+        // missing and empty are two refusals, the way the schema has them: a
+        // client that sent the field an empty value has a different bug from one
+        // that omitted it
+        if (given === undefined)
             throw new types_js_1.ApiError(400, `"${param.name}" is required`);
+        if (given === '')
+            throw new types_js_1.ApiError(400, `"${param.name}" is not allowed to be empty`);
     }
 };
 /** The drive path a write names: the query parameter wins over the form field. */
@@ -44,7 +49,7 @@ const dispatch = async (services, routeId, request = {}) => {
     const route = (0, index_js_1.routeById)(routeId);
     if (!route)
         throw new types_js_1.ApiError(404, `No such operation: ${routeId}`);
-    const { drive, identity, records } = services;
+    const { drive, identity, records, code } = services;
     // The server authenticates before its payload schema runs, so an anonymous
     // request with an incomplete body is a 401 there rather than a 400. The order
     // is only observable on the route groups that gate on a caller: the sign-in
@@ -69,6 +74,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}.`);
@@ -92,7 +103,7 @@ const dispatch = async (services, routeId, request = {}) => {
                     status: 200,
                     body: await identity.token({
                         clientId: String(body.clientId ?? ''),
-                        code: String(body.code ?? '')
+                        code: body.code
                     })
                 };
             case 'POST /SASjsApi/auth/refresh':
@@ -166,6 +177,31 @@ const dispatch = async (services, routeId, request = {}) => {
         }
         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
@@ -219,6 +255,26 @@ const dispatch = async (services, routeId, request = {}) => {
                 status: 200,
                 body: await required().deleteUser(await caller(), { username: String(params.username ?? '') }, { password: body.password })
             };
+        case 'POST /SASjsApi/code/lint':
+            if (!code)
+                throw new types_js_1.ApiError(501, `This host has no code service, so it cannot answer ${routeId}.`);
+            return {
+                status: 200,
+                body: await code.lint(await caller(), {
+                    code: body.code,
+                    filePath: body.filePath
+                })
+            };
+        case 'POST /SASjsApi/code/format':
+            if (!code)
+                throw new types_js_1.ApiError(501, `This host has no code service, so it cannot answer ${routeId}.`);
+            return {
+                status: 200,
+                body: await code.format(await caller(), {
+                    code: body.code,
+                    filePath: body.filePath
+                })
+            };
         case 'GET /SASjsApi/info/authorizedRoutes':
             return {
                 status: 200,
@@ -332,6 +388,12 @@ const dispatch = async (services, routeId, request = {}) => {
 exports.dispatch = dispatch;
 /** Whether a route is one `dispatch` can answer today. */
 exports.HANDLED_ROUTES = [
+    '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',
     'GET /SASjsApi/info/myAuthorizedRoutes',
     'GET /SASjsApi/drive/file',

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.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.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.
  *
@@ -67,6 +67,8 @@ Object.defineProperty(exports, "createIdentityService", { enumerable: true, get:
 var records_js_1 = require("./identity/records.js");
 Object.defineProperty(exports, "createRecordService", { enumerable: true, get: function () { return records_js_1.createRecordService; } });
 Object.defineProperty(exports, "sanitiseDisplayName", { enumerable: true, get: function () { return records_js_1.sanitiseDisplayName; } });
+var code_js_1 = require("./corpus/code.js");
+Object.defineProperty(exports, "CODE_CORPUS", { enumerable: true, get: function () { return code_js_1.CODE_CORPUS; } });
 var memory_store_js_2 = require("./identity/memory-store.js");
 Object.defineProperty(exports, "MemoryIdentityStore", { enumerable: true, get: function () { return memory_store_js_2.MemoryIdentityStore; } });
 var fixture_js_1 = require("./identity/fixture.js");
@@ -77,6 +79,8 @@ 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 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'
             }
         ]
     },

package/build/cjs/routes/overlay.js

@@ -26,9 +26,7 @@ exports.TAG_CAPABILITIES = {
  * thing thirty times.
  */
 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 EDITOR = 'Linting and formatting come from @sasjs/lint, which this package does not depend on. They land with the code routes so an editor has one wiring.';
 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.';
@@ -96,8 +94,14 @@ exports.OVERLAY = {
     // Code - the editor's three calls, and the runtime one
     'POST /SASjsApi/code/execute': { implemented: false, reason: RUNTIME },
     'POST /SASjsApi/code/trigger': { implemented: false, reason: RUNTIME },
-    'POST /SASjsApi/code/lint': { implemented: false, reason: EDITOR },
-    'POST /SASjsApi/code/format': { implemented: false, reason: EDITOR },
+    'POST /SASjsApi/code/lint': {
+        implemented: true,
+        capabilities: ['identity']
+    },
+    'POST /SASjsApi/code/format': {
+        implemented: true,
+        capabilities: ['identity']
+    },
     // Drive - the file and folder rules, and the three deploy routes
     // The body is the file itself, so there is nothing to annotate
     'GET /SASjsApi/drive/file': { implemented: true },
@@ -200,22 +204,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;

package/build/cjs/session/service.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSessionService = void 0;
+const types_js_1 = require("../types.js");
+/**
+ * The four session routes, over the host's own session store.
+ *
+ * The caller passes a `Subject` and nothing else: which account that is, whether
+ * it is an administrator, and whether the session is theirs are all resolved
+ * here, against the same store the records service reads. A host never states a
+ * role.
+ *
+ * `404` covers both "no such session" and "not yours", on purpose: a session id
+ * is handed to the caller that triggered the program and is built from a
+ * timestamp plus a small random number, so it is guessable within a window, and
+ * confirming the id exists would say it was right.
+ */
+const createSessionService = (store, host) => {
+    /** The server's wording, so adopting it here does not become a later change. */
+    const notFound = (id) => `Session with ID '${id}' was not found.`;
+    /** The caller, and the session if they may see it - or the 404 that hides it. */
+    const visible = async (caller, id) => {
+        if (!caller)
+            throw new types_js_1.ApiError(401, 'Unauthorized');
+        const reader = await store.userById(caller.userId);
+        if (!reader || !reader.isActive)
+            throw new types_js_1.ApiError(401, 'Unauthorized');
+        const session = await host.session(id);
+        if (!session)
+            throw new types_js_1.ApiError(404, notFound(id));
+        // the uid is the key to compare; a name is the fallback a host may need
+        const owner = session.owner;
+        if (owner !== reader.uid && owner !== reader.username && !reader.isAdmin)
+            throw new types_js_1.ApiError(404, notFound(id));
+        return session;
+    };
+    return {
+        async summary(caller, id) {
+            const session = await visible(caller, id);
+            return session.summary;
+        },
+        async state(caller, id) {
+            await visible(caller, id);
+            const state = await host.state(id);
+            if (!state)
+                throw new types_js_1.ApiError(404, notFound(id));
+            return state;
+        },
+        async log(caller, id) {
+            await visible(caller, id);
+            const log = await host.log(id);
+            if (log === undefined)
+                throw new types_js_1.ApiError(404, notFound(id));
+            return log;
+        },
+        async output(caller, id) {
+            await visible(caller, id);
+            const output = await host.output(id);
+            if (output === undefined)
+                throw new types_js_1.ApiError(404, notFound(id));
+            return output;
+        }
+    };
+};
+exports.createSessionService = createSessionService;

package/build/esm/code/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The code service, on its own entry point.
+ *
+ * `@sasjs/lint` reads the filesystem (its config resolution walks up for a
+ * `.sasjslint`), so it cannot be bundled for a service worker: the package root
+ * stays free of it and a host that wants these routes imports `@sasjs/api/code`.
+ */
+export { createCodeService } from './service.js';
+export type { CodeRequest, CodeService, CodeServiceOptions } from './service.js';
+//# sourceMappingURL=index.d.ts.map

package/build/esm/code/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/code/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAChD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA"}

package/build/esm/code/index.js

@@ -0,0 +1,8 @@
+/**
+ * The code service, on its own entry point.
+ *
+ * `@sasjs/lint` reads the filesystem (its config resolution walks up for a
+ * `.sasjslint`), so it cannot be bundled for a service worker: the package root
+ * stays free of it and a host that wants these routes imports `@sasjs/api/code`.
+ */
+export { createCodeService } from './service.js';