@sasjs/api 0.11.0 → 0.13.0

package/build/cjs/corpus/session.js

@@ -3,7 +3,10 @@ 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}',
@@ -36,6 +39,28 @@ exports.SESSION_CORPUS = [
             }
         }
     },
+    {
+        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',
@@ -53,6 +78,21 @@ exports.SESSION_CORPUS = [
         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',
@@ -60,6 +100,21 @@ exports.SESSION_CORPUS = [
         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',
@@ -69,5 +124,19 @@ exports.SESSION_CORPUS = [
             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. */
@@ -169,12 +170,24 @@ const dispatch = async (services, routeId, request = {}) => {
                 status: 200,
                 body: await drive.rename(String(request.body?.oldPath || ''), String(request.body?.newPath || ''))
             };
+        // The archive is the host's transport - multer and a zip library on a
+        // server, `DecompressionStream` in a worker - and it hands this the same tree
+        // `POST /deploy` takes. The deploy cap is measured on that tree, after
+        // expansion, which is why the two share this path rather than reading bytes.
+        case 'POST /SASjsApi/drive/deploy/upload':
         case 'POST /SASjsApi/drive/deploy': {
             // `streamWebFolder` is the host's: publishing an app stream is not a drive
             // operation, and a host that has no app stream ignores it.
             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
@@ -388,6 +401,8 @@ const dispatch = async (services, routeId, request = {}) => {
 exports.dispatch = dispatch;
 /** Whether a route is one `dispatch` can answer today. */
 exports.HANDLED_ROUTES = [
+    'POST /SASjsApi/drive/deploy/upload',
+    'DELETE /SASjsApi/drive/deploy',
     'GET /SASjsApi/session/{sessionId}',
     'GET /SASjsApi/session/{sessionId}/log',
     'GET /SASjsApi/session/{sessionId}/output',

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.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;
+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,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 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");

package/build/cjs/routes/generated.js

@@ -1301,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.'
             }
         ]
     },
@@ -1323,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.'
             }
         ]
     },
@@ -1345,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.'
             }
         ]
     },
@@ -1367,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

@@ -30,8 +30,6 @@ const RUNTIME = 'Starting a program needs a runtime port, which this package doe
 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: '',
@@ -159,16 +157,10 @@ exports.OVERLAY = {
             500: { status: 'failure', message: 'Deployment failed!' }
         }
     },
-    'POST /SASjsApi/drive/deploy/upload': {
-        implemented: false,
-        reason: ARCHIVE
-    },
+    'POST /SASjsApi/drive/deploy/upload': { implemented: true },
     // `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 },

package/build/esm/corpus/deploy.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The deploy routes' conformance corpus.
+ *
+ * `DELETE /SASjsApi/drive/deploy` documents three answers - `200`, `400` and
+ * `404` - and each has a case here, which is what
+ * `spec/corpus-parity.spec.ts` enforces in both directions.
+ *
+ * **The folder is the identity.** An app is one thing to deploy and one thing to
+ * remove; its name is a label on it. The document requires both body values, so a
+ * caller must supply both, but only the folder decides what is deleted - and the
+ * case below with a stale name and the right folder pins exactly that, because a
+ * name-keyed lookup would answer 404 there and leave the app in place.
+ */
+import type { CorpusCase } from './drive.js';
+export declare const DEPLOY_CORPUS: CorpusCase[];
+//# sourceMappingURL=deploy.d.ts.map

package/build/esm/corpus/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../../src/corpus/deploy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAW5C,eAAO,MAAM,aAAa,EAAE,UAAU,EAmIrC,CAAA"}

package/build/esm/corpus/deploy.js

@@ -0,0 +1,136 @@
+const SUBJECT = { userId: 'user-admin', clientId: 'web_app' };
+/** A tree of `count` file members, for the deploy cap. */
+const manyMembers = (count) => Array.from({ length: count }, (_, at) => ({
+    name: `file-${at}.txt`,
+    type: 'file',
+    code: ''
+}));
+export const 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.' }
+    },
+    // ------------------------------------------- the uploaded-archive route
+    // The archive is expanded by the host, so what arrives here is the same tree
+    // `POST /deploy` takes - which is why every answer below matches its twin.
+    {
+        id: 'upload-tree',
+        route: 'POST /SASjsApi/drive/deploy/upload',
+        description: 'writes the tree an uploaded archive expanded to',
+        request: {
+            subject: SUBJECT,
+            body: {
+                appLoc: '/Public/apps/uploaded',
+                fileTree: {
+                    members: [
+                        { name: 'index.html', type: 'file', code: 'PGgxPkhlbGxvPC9oMT4=' }
+                    ]
+                }
+            }
+        },
+        expect: {
+            status: 200,
+            body: {
+                status: 'success',
+                message: 'Files deployed successfully to @sasjs/server.'
+            }
+        }
+    },
+    {
+        id: 'upload-refused-by-shape',
+        route: 'POST /SASjsApi/drive/deploy/upload',
+        description: 'refuses an expansion that is not a tree',
+        request: {
+            subject: SUBJECT,
+            body: { appLoc: '/Public/apps/bad', fileTree: { members: 1 } }
+        },
+        expect: {
+            status: 400,
+            body: {
+                status: 'failure',
+                message: 'Provided not supported data format.'
+            },
+            error: 'Provided not supported data format.'
+        }
+    },
+    {
+        id: 'upload-refused-by-entry-count',
+        route: 'POST /SASjsApi/drive/deploy/upload',
+        description: 'applies the deploy cap to the expanded tree, not the bytes',
+        request: {
+            subject: SUBJECT,
+            body: {
+                appLoc: '/Public/apps/many',
+                fileTree: { members: manyMembers(10001) }
+            }
+        },
+        expect: {
+            status: 413,
+            body: {
+                status: 'failure',
+                message: 'The file tree exceeds the deploy limit: 10001 entries (maximum 10000).'
+            },
+            error: 'The file tree exceeds the deploy limit: 10001 entries (maximum 10000).'
+        }
+    },
+    {
+        id: 'upload-refused-by-store',
+        route: 'POST /SASjsApi/drive/deploy/upload',
+        description: 'answers the routes 500 when the drive refuses the write',
+        unwritable: true,
+        request: {
+            subject: SUBJECT,
+            body: {
+                appLoc: '/Public/apps/demo',
+                fileTree: {
+                    members: [{ name: 'run', type: 'service', code: '%put hi;' }]
+                }
+            }
+        },
+        expect: {
+            status: 500,
+            body: { status: 'failure', message: 'Deployment failed!' },
+            error: 'Deployment failed!'
+        }
+    }
+];

package/build/esm/corpus/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/corpus/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAWnD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;IAC9B,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,UAAU,KAAG,QAmBlD,CAAA;AAkBD;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAClB,UAAU,UAAU,EACpB,WAAU,QAAgC,KACzC,OAAO,CAAC,UAAU,CAepB,CAAA"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/corpus/runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAYnD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;IAC9B,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,UAAU,KAAG,QAoBlD,CAAA;AAkBD;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAClB,UAAU,UAAU,EACpB,WAAU,QAAgC,KACzC,OAAO,CAAC,UAAU,CAepB,CAAA"}

package/build/esm/corpus/runner.js

@@ -1,6 +1,7 @@
 import { dispatch } from '../host/dispatch.js';
 import { createDriveService } from '../drive/service.js';
 import { MemoryDriveStore } from '../drive/memory-store.js';
+import { MemoryAppStreamRegistry } from '../drive/registry.js';
 import { createIdentityService } from '../identity/service.js';
 import { createRecordService } from '../identity/records.js';
 import { createSessionService } from '../session/service.js';
@@ -26,6 +27,7 @@ export const servicesFor = (testCase) => {
             : new MemoryDriveStore(testCase.seed || {})),
         identity: createIdentityService(identity),
         records: createRecordService(identity),
+        registry: new MemoryAppStreamRegistry(),
         session: createSessionService(identity, new MemorySessionHost())
     };
 };

package/build/esm/corpus/session.d.ts

@@ -1,15 +1,16 @@
 /**
  * The session routes' conformance corpus.
  *
- * Only the `200` answers are here, and that is a statement about the document
- * rather than about the routes: sasjs/server documents these four with a `200`
- * and nothing else, so `spec/corpus-parity.spec.ts` refuses a case that pins a
- * refusal. Their `401` and the `404` that covers both "no such session" and
- * "not yours" are pinned in `spec/session.spec.ts` instead, which the parity
- * gate does not govern.
+ * Every status the document states for these four routes has a case, in both
+ * directions - that is what `spec/corpus-parity.spec.ts` enforces. The refusals
+ * arrived here only after sasjs/server#574 documented them: until then the
+ * package answered a 401 and a 404 that the document did not state, and a case
+ * pinning one would have been called drift.
  *
- * The routes are in `documentRefusals.baseline.json` upstream; when they carry
- * their `@Response(401)` and `@Response(404)`, those cases move here.
+ * `404` covers an unknown session and someone else's alike, on purpose - the id
+ * is guessable within a window, so confirming that it exists would say the id
+ * was right. The cases below keep the two apart so a change that starts
+ * answering `403` for a foreign session is visible.
  */
 import type { CorpusCase } from './drive.js';
 export declare const SESSION_CORPUS: CorpusCase[];

package/build/esm/corpus/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/corpus/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAK5C,eAAO,MAAM,cAAc,EAAE,UAAU,EAmEtC,CAAA"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/corpus/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAQ5C,eAAO,MAAM,cAAc,EAAE,UAAU,EAyItC,CAAA"}

package/build/esm/corpus/session.js

@@ -1,6 +1,9 @@
 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';
 export const SESSION_CORPUS = [
+    // ---------------------------------------------------------------- summary
     {
         id: 'session-summary-own',
         route: 'GET /SASjsApi/session/{sessionId}',
@@ -33,6 +36,28 @@ export const SESSION_CORPUS = [
             }
         }
     },
+    {
+        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',
@@ -50,6 +75,21 @@ export const SESSION_CORPUS = [
         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',
@@ -57,6 +97,21 @@ export const SESSION_CORPUS = [
         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',
@@ -66,5 +121,19 @@ export const SESSION_CORPUS = [
             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/esm/drive/registry.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The app streams a host has published, as the API needs to unpublish one.
+ *
+ * A published stream is the host's own record - a directory convention, a
+ * registry table, whatever it uses to know that `/Public/myApp` is served at
+ * `/Public/myApp/index.html`. The package cannot invent it, so the route takes
+ * this port and answers 501 without it, the same way the session routes do.
+ */
+export interface AppStreamRegistry {
+    /**
+     * Removes the app published at `appLoc`.
+     *
+     * **The folder is the identity.** An app is one thing to deploy and one thing
+     * to delete, and what it is called is a label on it: two apps can share a
+     * folder only as a special case, and they are still one thing to load or
+     * remove. So the lookup is by folder, and a name that no longer matches the
+     * one recorded does not turn a correct deletion into a `404`.
+     *
+     * `false` when nothing is published at that folder, which the route reports as
+     * a 404 - a delete that silently succeeded on a folder nobody deployed would
+     * hide a caller's typo.
+     */
+    unpublish(appLoc: string): Promise<boolean>;
+}
+export interface UnpublishBody {
+    streamServiceName?: string;
+    appLoc?: string;
+}
+/**
+ * `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.
+ */
+export declare const unpublishAppStream: (registry: AppStreamRegistry, body: UnpublishBody | undefined) => Promise<{
+    status: "success";
+}>;
+/**
+ * The registry the corpus and the package's own tests read: one published app,
+ * identified by its folder alone.
+ */
+export declare class MemoryAppStreamRegistry implements AppStreamRegistry {
+    private readonly folders;
+    constructor(folders?: string[]);
+    unpublish(appLoc: string): Promise<boolean>;
+}
+//# sourceMappingURL=registry.d.ts.map