@sasjs/api 0.10.0 → 0.12.0

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/corpus/code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../src/corpus/code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,EAAE,UAAU,EA6CnC,CAAA"}
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../../src/corpus/code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW,EAAE,UAAU,EAoFnC,CAAA"}

package/build/esm/corpus/code.js

@@ -35,13 +35,50 @@ export const 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/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;AAI5C,eAAO,MAAM,aAAa,EAAE,UAAU,EA6CrC,CAAA"}

package/build/esm/corpus/deploy.js

@@ -0,0 +1,47 @@
+const SUBJECT = { userId: 'user-admin', clientId: 'web_app' };
+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.' }
+    }
+];

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;AASnD,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,QAkBlD,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,8 +1,11 @@
 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';
+import { MemorySessionHost } from '../session/memory-host.js';
 import { MemoryIdentityStore } from '../identity/memory-store.js';
 import { DEFAULT_IDENTITY } from '../identity/fixture.js';
 import { isApiError } from '../types.js';
@@ -23,7 +26,9 @@ export const servicesFor = (testCase) => {
             ? new RefusingDriveStore(testCase.seed || {})
             : new MemoryDriveStore(testCase.seed || {})),
         identity: createIdentityService(identity),
-        records: createRecordService(identity)
+        records: createRecordService(identity),
+        registry: new MemoryAppStreamRegistry(),
+        session: createSessionService(identity, new MemorySessionHost())
     };
 };
 /**

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

@@ -0,0 +1,17 @@
+/**
+ * The session routes' conformance corpus.
+ *
+ * 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.
+ *
+ * `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[];
+//# sourceMappingURL=session.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,139 @@
+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}',
+        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/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

package/build/esm/drive/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/drive/registry.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;OAYG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC5C;AAED,MAAM,WAAW,aAAa;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAC7B,UAAU,iBAAiB,EAC3B,MAAM,aAAa,GAAG,SAAS,KAC9B,OAAO,CAAC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAU/B,CAAA;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,iBAAiB;IAC/D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;gBAEzB,OAAO,GAAE,MAAM,EAAsB;IAI3C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGlD"}

package/build/esm/drive/registry.js

@@ -0,0 +1,33 @@
+import { ApiError } from '../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.
+ */
+export const unpublishAppStream = async (registry, body) => {
+    if (!body?.streamServiceName)
+        throw new ApiError(400, '"streamServiceName" is required');
+    if (!body.appLoc)
+        throw new ApiError(400, '"appLoc" is required');
+    if (!(await registry.unpublish(body.appLoc)))
+        throw new ApiError(404, 'No such app stream entry.');
+    return { status: 'success' };
+};
+/**
+ * The registry the corpus and the package's own tests read: one published app,
+ * identified by its folder alone.
+ */
+export class MemoryAppStreamRegistry {
+    constructor(folders = ['/Public/myApp']) {
+        this.folders = new Set(folders);
+    }
+    async unpublish(appLoc) {
+        return this.folders.delete(appLoc);
+    }
+}

package/build/esm/host/dispatch.d.ts

@@ -1,6 +1,8 @@
 import type { DriveService } from '../drive/service.js';
 import type { IdentityService } from '../identity/service.js';
 import type { RecordService } from '../identity/records.js';
+import type { SessionService } from '../session/service.js';
+import type { AppStreamRegistry } from '../drive/registry.js';
 import type { CodeService } from '../code/service.js';
 import type { Subject } from '../identity/types.js';
 export interface ApiRequest {
@@ -45,6 +47,16 @@ export interface Services {
     identity?: IdentityService;
     /** Users, groups, permission rules and clients. Absent, the record routes answer 501. */
     records?: RecordService;
+    /**
+     * A triggered session's record, log, output and state. A host without one
+     * answers 501 for these four, naming the capability.
+     */
+    session?: SessionService;
+    /**
+     * The app streams a host has published. Absent, `DELETE /drive/deploy`
+     * answers 501 - the package cannot know a host's stream registry.
+     */
+    registry?: AppStreamRegistry;
 }
 export declare const dispatch: (services: Services, routeId: string, request?: ApiRequest) => Promise<ApiResponse>;
 /** Whether a route is one `dispatch` can answer today. */

package/build/esm/host/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../src/host/dispatch.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAOnD,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,oFAAoF;IACpF,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAA;IACtD;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,mBAAmB;IACnB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,KAAK,EAAE,YAAY,CAAA;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,yFAAyF;IACzF,OAAO,CAAC,EAAE,aAAa,CAAA;CACxB;AA2CD,eAAO,MAAM,QAAQ,GACnB,UAAU,QAAQ,EAClB,SAAS,MAAM,EACf,UAAS,UAAe,KACvB,OAAO,CAAC,WAAW,CA2YrB,CAAA;AAED,0DAA0D;AAC1D,eAAO,MAAM,cAAc,EAAE,MAAM,EA4ClC,CAAA"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../src/host/dispatch.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAOnD,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IAC1C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9B;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,oFAAoF;IACpF,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,CAAA;IACtD;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,iEAAiE;IACjE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,mBAAmB;IACnB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,GAAG,UAAU,CAAA;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,KAAK,EAAE,YAAY,CAAA;IACnB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAA;IAC1B,yFAAyF;IACzF,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,iBAAiB,CAAA;CAC7B;AA2CD,eAAO,MAAM,QAAQ,GACnB,UAAU,QAAQ,EAClB,SAAS,MAAM,EACf,UAAS,UAAe,KACvB,OAAO,CAAC,WAAW,CAycrB,CAAA;AAED,0DAA0D;AAC1D,eAAO,MAAM,cAAc,EAAE,MAAM,EAiDlC,CAAA"}

package/build/esm/host/dispatch.js

@@ -1,4 +1,5 @@
 import { routeById } from '../routes/index.js';
+import { unpublishAppStream } from '../drive/registry.js';
 import { ApiError } from '../types.js';
 import { DEPLOY_SUCCESS } from '../drive/deploy.js';
 /** The defaults sasjs/server's Client schema applies to an omitted lifetime. */
@@ -71,6 +72,12 @@ export 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 ApiError(501, `This host has no session service, so it cannot answer ${routeId}.`);
+        return services.session;
+    };
     const required = () => {
         if (!records)
             throw new ApiError(501, `This host has no record service, so it cannot answer ${routeId}.`);
@@ -166,8 +173,40 @@ export const dispatch = async (services, routeId, request = {}) => {
             await drive.deploy(String(body.appLoc ?? ''), body.fileTree);
             return { status: 200, body: DEPLOY_SUCCESS };
         }
+        case 'DELETE /SASjsApi/drive/deploy':
+            if (!services.registry)
+                throw new ApiError(501, `This host has no app stream registry, so it cannot answer ${routeId}.`);
+            return {
+                status: 200,
+                body: await 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
@@ -353,6 +392,11 @@ export const dispatch = async (services, routeId, request = {}) => {
 };
 /** Whether a route is one `dispatch` can answer today. */
 export const 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/esm/index.d.ts

@@ -38,6 +38,8 @@ export type { IdentityFixture, IdentityFixtureClient, IdentityFixtureCode, Ident
 export type { IdentityClient, IdentityClientRecord, IdentityGroupRecord, IdentityPermissionRecord, IdentityStore, IdentityUser, IdentityUserRecord, NewGroup, NewPermission, NewUser, Subject, TokenPair, UserChange } from './identity/types.js';
 export { DRIVE_CORPUS } from './corpus/drive.js';
 export { IDENTITY_CORPUS } from './corpus/identity.js';
+export { DEPLOY_CORPUS } from './corpus/deploy.js';
+export { SESSION_CORPUS } from './corpus/session.js';
 export { RECORD_CORPUS, ADMIN_SIGNED_IN, PROVIDER_MANAGED } from './corpus/records.js';
 export type { CorpusCase } from './corpus/drive.js';
 export { runCase, servicesFor } from './corpus/runner.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,cAAc,YAAY,CAAA;AAC1B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,OAAO,EACP,QAAQ,EACR,MAAM,EACP,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,iBAAiB,EAClB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,UAAU,EACX,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACV,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAChE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAG7D,cAAc,2BAA2B,CAAA;AACzC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACb,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACd,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,aAAa,EACd,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,aAAa,EACb,OAAO,EACP,OAAO,EACP,SAAS,EACT,UAAU,EACX,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACzD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,cAAc,YAAY,CAAA;AAC1B,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,OAAO,EACP,QAAQ,EACR,MAAM,EACP,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,iBAAiB,EAClB,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,UAAU,EACX,MAAM,mBAAmB,CAAA;AAC1B,YAAY,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACV,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAChE,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAG7D,cAAc,2BAA2B,CAAA;AACzC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,YAAY,EACV,wBAAwB,EACxB,oBAAoB,EACpB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACb,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,eAAe,EACf,WAAW,EACX,aAAa,EACd,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,aAAa,EACd,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,EACxB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,QAAQ,EACR,aAAa,EACb,OAAO,EACP,OAAO,EACP,SAAS,EACT,UAAU,EACX,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,EACjB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACzD,YAAY,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA"}

package/build/esm/index.js

@@ -30,5 +30,7 @@ export { MemoryIdentityStore } from './identity/memory-store.js';
 export { DEFAULT_IDENTITY, IDENTITY_FORMAT, parseIdentity } from './identity/fixture.js';
 export { DRIVE_CORPUS } from './corpus/drive.js';
 export { IDENTITY_CORPUS } from './corpus/identity.js';
+export { DEPLOY_CORPUS } from './corpus/deploy.js';
+export { SESSION_CORPUS } from './corpus/session.js';
 export { RECORD_CORPUS, ADMIN_SIGNED_IN, PROVIDER_MANAGED } from './corpus/records.js';
 export { runCase, servicesFor } from './corpus/runner.js';

package/build/esm/routes/generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generated.d.ts","sourceRoot":"","sources":["../../../src/routes/generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAs3D5C,CAAA"}
+{"version":3,"file":"generated.d.ts","sourceRoot":"","sources":["../../../src/routes/generated.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,eAAO,MAAM,gBAAgB,EAAE,cAAc,EAw6D5C,CAAA"}