@elaraai/e3-cloud-client 0.0.0-stage → 1.0.89-alpha.0

package/dist/src/feedback.js

@@ -0,0 +1,166 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * Feedback on components: notes users send from a workspace-scoped
+ * page about a part of it, kept per workspace, numbered `FB-<number>`.
+ *
+ * - Owners and admins, and a user in a workspace they are granted an app of,
+ *   ask whether it takes feedback ({@link getFeedbackSettings}), send a note
+ *   ({@link addFeedback}), list their own ({@link listMyFeedback}) and read
+ *   one of their own whole ({@link getFeedback}, {@link feedbackScreenshotUrl}).
+ * - The repository's owners and the deployment's admins list the
+ *   workspace's notes ({@link listFeedback}), read any, close and reopen them
+ *   ({@link closeFeedback}, {@link reopenFeedback}), and turn feedback on or
+ *   off ({@link putFeedbackSettings}).
+ *
+ * A send while feedback is off throws `ApiError` with code
+ * `feedback_disabled`; a note that is not there, `not_found`; another sender's
+ * note, `forbidden`.
+ */
+import { NullType } from '@elaraai/east';
+import { FeedbackListType, FeedbackMineType, FeedbackNoteType, FeedbackScreenshotUrlType, FeedbackSendRequestType, FeedbackSentType, FeedbackSettingsType, } from '@elaraai/e3-cloud-types';
+import { get, post, put } from '@elaraai/e3-api-client';
+const enc = encodeURIComponent;
+const feedbackBase = (repo, ws) => `/repos/${enc(repo)}/workspaces/${enc(ws)}/feedback`;
+/** A query string of the parameters that are set, with its `?`, or nothing. */
+function queryOf(params) {
+    const query = new URLSearchParams();
+    for (const [name, value] of Object.entries(params)) {
+        if (value !== undefined)
+            query.set(name, String(value));
+    }
+    const text = query.toString();
+    return text === '' ? '' : `?${text}`;
+}
+/**
+ * Whether a workspace takes feedback. The UI asks once per workspace page.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param options - Request options including auth token
+ * @returns `{ enabled }`
+ */
+export async function getFeedbackSettings(url, repo, ws, options) {
+    return get(url, `${feedbackBase(repo, ws)}/settings`, FeedbackSettingsType, options);
+}
+/**
+ * Turn a workspace's feedback on or off (owner or admin). Its notes are kept
+ * either way, and numbering goes on where it stopped.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param enabled - Whether the workspace takes feedback
+ * @param options - Request options including auth token
+ * @returns The workspace's settings, as set
+ */
+export async function putFeedbackSettings(url, repo, ws, enabled, options) {
+    return put(url, `${feedbackBase(repo, ws)}/settings`, { enabled }, FeedbackSettingsType, FeedbackSettingsType, options);
+}
+/**
+ * Send a note: its text, the page, the part, the data behind the view and the
+ * screenshot, in one body. The server adds the sender and the time.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param request - The note and its context
+ * @param options - Request options including auth token
+ * @returns The note's id (`FB-<number>`) and number
+ * @throws {ApiError} `feedback_disabled` while the workspace takes no
+ *   feedback; `bad_request` naming a field past its limit
+ */
+export async function addFeedback(url, repo, ws, request, options) {
+    return post(url, feedbackBase(repo, ws), request, FeedbackSendRequestType, FeedbackSentType, options);
+}
+/**
+ * A page of the caller's own notes of one status, newest first, each as a
+ * summary (its first 200 characters).
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param options - Request options including auth token
+ * @param page - The status, the page's size and the cursor
+ * @returns The page and the next page's cursor
+ */
+export async function listMyFeedback(url, repo, ws, options, page = {}) {
+    return get(url, `${feedbackBase(repo, ws)}/mine${queryOf({ ...page })}`, FeedbackMineType, options);
+}
+/**
+ * A page of a workspace's notes of one status, newest first, each whole, and
+ * how many are open and closed (owner or admin).
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param options - Request options including auth token
+ * @param page - The status, the page's size and the cursor
+ * @returns The page, the next page's cursor, and the counts
+ */
+export async function listFeedback(url, repo, ws, options, page = {}) {
+    return get(url, `${feedbackBase(repo, ws)}${queryOf({ ...page })}`, FeedbackListType, options);
+}
+/**
+ * A note, whole (owner or admin, or its sender).
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param number - The note's number
+ * @param options - Request options including auth token
+ * @param opts - Its status, when known
+ * @returns The note
+ * @throws {ApiError} `not_found` when the workspace has no such note (of that status)
+ */
+export async function getFeedback(url, repo, ws, number, options, opts = {}) {
+    return get(url, `${feedbackBase(repo, ws)}/${number}${queryOf({ status: opts.status })}`, FeedbackNoteType, options);
+}
+/**
+ * Where a note's screenshot can be read: a URL good for 15 minutes, fetched
+ * without the API's auth (owner or admin, or its sender).
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param number - The note's number
+ * @param options - Request options including auth token
+ * @param opts - Its status, when known
+ * @returns The URL
+ * @throws {ApiError} `not_found` when the note is not there, or was sent
+ *   without a screenshot
+ */
+export async function feedbackScreenshotUrl(url, repo, ws, number, options, opts = {}) {
+    const answer = await get(url, `${feedbackBase(repo, ws)}/${number}/screenshot${queryOf({ status: opts.status })}`, FeedbackScreenshotUrlType, options);
+    return answer.url;
+}
+/**
+ * Close a note (owner or admin). Closing a closed note changes nothing.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param number - The note's number
+ * @param options - Request options including auth token
+ * @returns The note, closed
+ */
+export async function closeFeedback(url, repo, ws, number, options) {
+    return post(url, `${feedbackBase(repo, ws)}/${number}/close`, null, NullType, FeedbackNoteType, options);
+}
+/**
+ * Reopen a note (owner or admin). Reopening an open note changes nothing.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param number - The note's number
+ * @param options - Request options including auth token
+ * @returns The note, open
+ */
+export async function reopenFeedback(url, repo, ws, number, options) {
+    return post(url, `${feedbackBase(repo, ws)}/${number}/reopen`, null, NullType, FeedbackNoteType, options);
+}
+//# sourceMappingURL=feedback.js.map

package/dist/src/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../../src/feedback.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,GAOrB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAuB,MAAM,wBAAwB,CAAC;AAE7E,MAAM,GAAG,GAAG,kBAAkB,CAAC;AAoB/B,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,EAAU,EAAE,EAAE,CAChD,UAAU,GAAG,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC,WAAW,CAAC;AAEvD,+EAA+E;AAC/E,SAAS,OAAO,CAAC,MAAmD;IAClE,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC9B,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AACvC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,IAAY,EACZ,EAAU,EACV,OAAuB;IAEvB,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAAC;AACvF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,IAAY,EACZ,EAAU,EACV,OAAgB,EAChB,OAAuB;IAEvB,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAAC;AAC1H,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,IAAY,EACZ,EAAU,EACV,OAA4B,EAC5B,OAAuB;IAEvB,OAAO,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;AACxG,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,IAAY,EACZ,EAAU,EACV,OAAuB,EACvB,OAA4B,EAAE;IAE9B,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;AACtG,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW,EACX,IAAY,EACZ,EAAU,EACV,OAAuB,EACvB,OAA4B,EAAE;IAE9B,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;AACjG,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,IAAY,EACZ,EAAU,EACV,MAAuB,EACvB,OAAuB,EACvB,OAA4B,EAAE;IAE9B,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,GAAG,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;AACvH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,GAAW,EACX,IAAY,EACZ,EAAU,EACV,MAAuB,EACvB,OAAuB,EACvB,OAA4B,EAAE;IAE9B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,cAAc,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,yBAAyB,EAAE,OAAO,CAAC,CAAC;IACvJ,OAAO,MAAM,CAAC,GAAG,CAAC;AACpB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,IAAY,EACZ,EAAU,EACV,MAAuB,EACvB,OAAuB;IAEvB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAC3G,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAW,EACX,IAAY,EACZ,EAAU,EACV,MAAuB,EACvB,OAAuB;IAEvB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;AAC5G,CAAC"}

package/dist/src/history.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * A workspace's history: its releases, rollbacks, deploys, app deploys
+ * and copies, each naming the package and apps it left the workspace running;
+ * and its staging, which protects it.
+ */
+import { type AddStagingRequest, type AddStagingResponse, type RepositoryReleaseSettings, type RepositoryHistory, type ReleaseRequest, type ReleaseResponse, type RollbackRequest, type StagingLink, type WorkspaceHistoryEntry, type WorkspaceHistoryPage, type WorkspaceReleaseSettings } from '@elaraai/e3-cloud-types';
+import { type RequestOptions } from '@elaraai/e3-api-client';
+/** Which page of a workspace's history to read. */
+export interface WorkspaceHistoryOptions {
+    /** The page's size (server default 25, at most 100) */
+    limit?: number;
+    /** The previous page's `next` */
+    before?: string;
+}
+/**
+ * A page of a workspace's history, newest first: each entry's kind, the
+ * package and apps it left running, who did it, its plan in words and how it
+ * ended. Owners and admins read it.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param options - Request options including auth token
+ * @param page - The page's size and the cursor
+ * @returns The page, and the next page's cursor
+ */
+export declare function workspaceHistory(url: string, repo: string, ws: string, options: RequestOptions, page?: WorkspaceHistoryOptions): Promise<WorkspaceHistoryPage>;
+/**
+ * Each workspace of a repository that has a history, in brief, in one request
+ * (owner or admin): its newest entry, its newest under way and its newest
+ * completed change, what a list of the repository's workspaces says of each.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param options - Request options including auth token
+ * @returns Each workspace with a history, by name
+ */
+export declare function repositoryHistory(url: string, repo: string, options: RequestOptions): Promise<RepositoryHistory>;
+/**
+ * An entry of a workspace's history, by its id.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param id - The entry's id
+ * @param options - Request options including auth token
+ * @returns The entry
+ */
+export declare function workspaceHistoryEntry(url: string, repo: string, ws: string, id: string, options: RequestOptions): Promise<WorkspaceHistoryEntry>;
+/**
+ * Releases another workspace to this one, or answers the plan (owner or
+ * admin): the target gets exactly the package and app versions the
+ * source runs, by hash, keeping its edited inputs and migrating its records
+ * as e3's deploy does; the datasets named are carried from the source.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param target - The workspace released to
+ * @param request - The workspace released, what to carry, whether to remove apps it lacks, and whether only to plan
+ * @param options - Request options including auth token
+ * @returns `planned`; `refused`, its problems in the plan; `released`, its
+ *   apps switched; or `releasing`, naming the deploy job `appDeployWait` waits on
+ */
+export declare function releaseWorkspace(url: string, repo: string, target: string, request: ReleaseRequest, options: RequestOptions): Promise<ReleaseResponse>;
+/**
+ * Rolls a workspace back to an entry of its history, or answers the plan
+ * (owner or admin): the entry's package and apps, exactly.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param request - The entry (none for the newest completed one that differs from what the workspace runs), and whether only to plan
+ * @param options - Request options including auth token
+ * @returns As {@link releaseWorkspace}
+ */
+export declare function rollbackWorkspace(url: string, repo: string, ws: string, request: RollbackRequest, options: RequestOptions): Promise<ReleaseResponse>;
+/**
+ * Where a workspace releases to.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param options - Request options including auth token
+ * @returns Its release settings
+ */
+export declare function getReleaseSettings(url: string, repo: string, ws: string, options: RequestOptions): Promise<WorkspaceReleaseSettings>;
+/**
+ * Adds a staging to a workspace, which is protected from then on (owner or
+ * admin): the staging starts as a copy of the workspace as
+ * it is now (made, or replacing a workspace of its name whole), or as the
+ * workspace of its name stands. Ask with `plan: true` to read what it would
+ * do, and change nothing.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param live - The workspace the staging releases to
+ * @param request - The staging's name, how it starts, and whether to plan only
+ * @param options - Request options including auth token
+ * @returns Its plan, asked for or done
+ */
+export declare function addStaging(url: string, repo: string, live: string, request: AddStagingRequest, options: RequestOptions): Promise<AddStagingResponse>;
+/**
+ * Stops a workspace's staging, which is no longer protected (admins only):
+ * nothing is deleted, and the workspace's history records who stopped it.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param live - The workspace whose staging stops
+ * @param options - Request options including auth token
+ * @returns The staging and the workspace it released to
+ */
+export declare function stopStaging(url: string, repo: string, live: string, options: RequestOptions): Promise<StagingLink>;
+/**
+ * Where each workspace of a repository releases to.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param options - Request options including auth token
+ * @returns Each workspace whose setting is set, and the workspace it releases to
+ */
+export declare function getRepositoryReleaseSettings(url: string, repo: string, options: RequestOptions): Promise<RepositoryReleaseSettings>;
+//# sourceMappingURL=history.d.ts.map

package/dist/src/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/history.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH,OAAO,EAYL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC9B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7E,mDAAmD;AACnD,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,IAAI,GAAE,uBAA4B,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAMxK;AAED;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAEtH;AAED;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAEtJ;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAE5J;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAE1J;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAE1I;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE1J;AAED;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAExH;AAED;;;;;;;GAOG;AACH,wBAAsB,4BAA4B,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAEzI"}

package/dist/src/history.js

@@ -0,0 +1,144 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * A workspace's history: its releases, rollbacks, deploys, app deploys
+ * and copies, each naming the package and apps it left the workspace running;
+ * and its staging, which protects it.
+ */
+import { AddStagingRequestType, AddStagingResponseType, ReleaseRequestType, ReleaseResponseType, RollbackRequestType, StagingLinkType, WorkspaceHistoryEntryType, WorkspaceHistoryPageType, WorkspaceReleaseSettingsType, RepositoryReleaseSettingsType, RepositoryHistoryType, } from '@elaraai/e3-cloud-types';
+import { del, get, post } from '@elaraai/e3-api-client';
+const enc = encodeURIComponent;
+/**
+ * A page of a workspace's history, newest first: each entry's kind, the
+ * package and apps it left running, who did it, its plan in words and how it
+ * ended. Owners and admins read it.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param options - Request options including auth token
+ * @param page - The page's size and the cursor
+ * @returns The page, and the next page's cursor
+ */
+export async function workspaceHistory(url, repo, ws, options, page = {}) {
+    const query = new URLSearchParams();
+    if (page.limit !== undefined)
+        query.set('limit', String(page.limit));
+    if (page.before !== undefined)
+        query.set('before', page.before);
+    const text = query.toString();
+    return get(url, `/repos/${enc(repo)}/workspaces/${enc(ws)}/history${text === '' ? '' : `?${text}`}`, WorkspaceHistoryPageType, options);
+}
+/**
+ * Each workspace of a repository that has a history, in brief, in one request
+ * (owner or admin): its newest entry, its newest under way and its newest
+ * completed change, what a list of the repository's workspaces says of each.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param options - Request options including auth token
+ * @returns Each workspace with a history, by name
+ */
+export async function repositoryHistory(url, repo, options) {
+    return get(url, `/repos/${enc(repo)}/history`, RepositoryHistoryType, options);
+}
+/**
+ * An entry of a workspace's history, by its id.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param id - The entry's id
+ * @param options - Request options including auth token
+ * @returns The entry
+ */
+export async function workspaceHistoryEntry(url, repo, ws, id, options) {
+    return get(url, `/repos/${enc(repo)}/workspaces/${enc(ws)}/history/${enc(id)}`, WorkspaceHistoryEntryType, options);
+}
+/**
+ * Releases another workspace to this one, or answers the plan (owner or
+ * admin): the target gets exactly the package and app versions the
+ * source runs, by hash, keeping its edited inputs and migrating its records
+ * as e3's deploy does; the datasets named are carried from the source.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param target - The workspace released to
+ * @param request - The workspace released, what to carry, whether to remove apps it lacks, and whether only to plan
+ * @param options - Request options including auth token
+ * @returns `planned`; `refused`, its problems in the plan; `released`, its
+ *   apps switched; or `releasing`, naming the deploy job `appDeployWait` waits on
+ */
+export async function releaseWorkspace(url, repo, target, request, options) {
+    return post(url, `/repos/${enc(repo)}/workspaces/${enc(target)}/releases`, request, ReleaseRequestType, ReleaseResponseType, options);
+}
+/**
+ * Rolls a workspace back to an entry of its history, or answers the plan
+ * (owner or admin): the entry's package and apps, exactly.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param request - The entry (none for the newest completed one that differs from what the workspace runs), and whether only to plan
+ * @param options - Request options including auth token
+ * @returns As {@link releaseWorkspace}
+ */
+export async function rollbackWorkspace(url, repo, ws, request, options) {
+    return post(url, `/repos/${enc(repo)}/workspaces/${enc(ws)}/rollback`, request, RollbackRequestType, ReleaseResponseType, options);
+}
+/**
+ * Where a workspace releases to.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param ws - Workspace name
+ * @param options - Request options including auth token
+ * @returns Its release settings
+ */
+export async function getReleaseSettings(url, repo, ws, options) {
+    return get(url, `/repos/${enc(repo)}/workspaces/${enc(ws)}/releases/settings`, WorkspaceReleaseSettingsType, options);
+}
+/**
+ * Adds a staging to a workspace, which is protected from then on (owner or
+ * admin): the staging starts as a copy of the workspace as
+ * it is now (made, or replacing a workspace of its name whole), or as the
+ * workspace of its name stands. Ask with `plan: true` to read what it would
+ * do, and change nothing.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param live - The workspace the staging releases to
+ * @param request - The staging's name, how it starts, and whether to plan only
+ * @param options - Request options including auth token
+ * @returns Its plan, asked for or done
+ */
+export async function addStaging(url, repo, live, request, options) {
+    return post(url, `/repos/${enc(repo)}/workspaces/${enc(live)}/staging`, request, AddStagingRequestType, AddStagingResponseType, options);
+}
+/**
+ * Stops a workspace's staging, which is no longer protected (admins only):
+ * nothing is deleted, and the workspace's history records who stopped it.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param live - The workspace whose staging stops
+ * @param options - Request options including auth token
+ * @returns The staging and the workspace it released to
+ */
+export async function stopStaging(url, repo, live, options) {
+    return del(url, `/repos/${enc(repo)}/workspaces/${enc(live)}/staging`, StagingLinkType, options);
+}
+/**
+ * Where each workspace of a repository releases to.
+ *
+ * @param url - Base URL of the e3 API server
+ * @param repo - Repository name
+ * @param options - Request options including auth token
+ * @returns Each workspace whose setting is set, and the workspace it releases to
+ */
+export async function getRepositoryReleaseSettings(url, repo, options) {
+    return get(url, `/repos/${enc(repo)}/release-settings`, RepositoryReleaseSettingsType, options);
+}
+//# sourceMappingURL=history.js.map

package/dist/src/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/history.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * e3-cloud-client: HTTP client library for e3 admin API
+ *
+ * This package provides a typed HTTP client for interacting with the e3 admin API,
+ * building on e3-api-client's HTTP utilities.
+ *
+ * Features:
+ * - Type-safe request/response handling using East types
+ * - BEAST2 binary serialization format
+ * - Exception-based error handling (throws ApiError on failures)
+ *
+ * @example
+ * ```typescript
+ * import { whoami, repoUsers, addUser, ApiError } from '@elaraai/e3-cloud-client';
+ * import { variant } from '@elaraai/east';
+ *
+ * const options = { token: accessToken };
+ *
+ * // Get current user
+ * const me = await whoami('https://e3.example.com', options);
+ *
+ * // Add a user holding the built-in All apps role
+ * try {
+ *   const user = await addUser(
+ *     'https://e3.example.com',
+ *     'my-repo',
+ *     { email: 'bob@example.com', role: variant('user', { roles: ['All apps'] }) },
+ *     options
+ *   );
+ * } catch (error) {
+ *   if (error instanceof ApiError) {
+ *     console.error(`Failed: ${error.code}`);
+ *   }
+ * }
+ * ```
+ */
+export { ApiError, AuthError, type RequestOptions } from '@elaraai/e3-api-client';
+export { whoami, repoUsers, addUser, removeUser, repoInvitations, revokeRepoInvitation } from './users.js';
+export { getSchedule, setSchedule, removeSchedule, listSchedules } from './schedules.js';
+export { listCompute, getCompute, setCompute, setComputeBatch, removeCompute, listTimeout, getTimeout, setTimeout, setTimeoutBatch, removeTimeout, removeTimeoutBatch, listTaskConfigs, listDelegation, setDelegation, removeDelegation, listFunctionDelegation, setFunctionDelegation, removeFunctionDelegation, getWidth, setWidth, removeWidth, repositorySettings, } from './task-configs.js';
+export { getUserSettings, putUserSettings, deleteUserSettings } from './user-settings.js';
+export { listSecrets, putSecret, deleteSecret } from './secrets.js';
+export { listInvitations, revokeInvitation, isInvitedSentinel } from './invitations.js';
+export { listAdminUsers, disableUser, enableUser, lookupPeople } from './admin-users.js';
+export { myMemberships } from './me.js';
+export { listRoles, getRole, putRole, deleteRole, myAccess, previewRole } from './roles.js';
+export type { Person, PersonList, RepositorySettings, WorkspaceSettings, WorkspaceLastRun, RepoRole, RepoUser, AddUserRequest, WhoamiResponse, AuthzErrorCode, Schedule, ScheduleRequest, ComputeSize, ComputeConfigMap, TaskTimeout, TimeoutConfigMap, TaskConfigs, } from '@elaraai/e3-cloud-types';
+export { getDelegationPolicy, setDelegationPolicy, getRackSecurityPolicy, setRackSecurityPolicy, listRacks, enrollRack, deregisterRack, rackActivity, approveRackBoot, ApproveBootRequestType, EnrollmentTokenType, type EnrollmentToken, } from './deployment-settings.js';
+export { listRecordInfos, recordAudit, recordStateAt, recordStatePage, recordValueChunks, rollbackRecord, listRecordBackups, createRecordBackup, restoreRecordBackup, recordBackupDownload, recordBackupStream, recordBackupValue, deleteRecordBackup, type RecordClientSource, type RecordStateAt, } from './records.js';
+export type { RecordList, RecordInfo, RecordAuditPage, RecordAuditEntry, RecordBackupInfo, RecordBackupList, RecordBackupDownload, } from '@elaraai/e3-cloud-types';
+export { getFeedbackSettings, putFeedbackSettings, addFeedback, listMyFeedback, listFeedback, getFeedback, feedbackScreenshotUrl, closeFeedback, reopenFeedback, type FeedbackStatusName, type FeedbackListOptions, type FeedbackNoteOptions, } from './feedback.js';
+export { feedbackId, FEEDBACK_NOTE_MAX_CHARS, FEEDBACK_TEXT_MAX_CHARS, FEEDBACK_URL_MAX_CHARS, FEEDBACK_SHORT_MAX_CHARS, FEEDBACK_DATASETS_MAX, FEEDBACK_NOTE_MAX_BYTES, FEEDBACK_SCREENSHOT_MAX_BYTES, FEEDBACK_SCREENSHOT_TYPES, FEEDBACK_SUMMARY_CHARS, FEEDBACK_PAGE_DEFAULT, FEEDBACK_PAGE_MAX, } from '@elaraai/e3-cloud-types';
+export type { FeedbackSendRequest, FeedbackSent, FeedbackPage, FeedbackPart, FeedbackPartKind, FeedbackScope, FeedbackRect, FeedbackPoint, FeedbackData, FeedbackImage, FeedbackScreenshotRequest, FeedbackNote, FeedbackSender, FeedbackScreenshot, FeedbackStatus, FeedbackSummary, FeedbackList, FeedbackMine, FeedbackCounts, FeedbackSettings, } from '@elaraai/e3-cloud-types';
+export { workspaceHistory, workspaceHistoryEntry, repositoryHistory, releaseWorkspace, rollbackWorkspace, getReleaseSettings, getRepositoryReleaseSettings, addStaging, stopStaging, type WorkspaceHistoryOptions, } from './history.js';
+export { WORKSPACE_HISTORY_PAGE_DEFAULT, WORKSPACE_HISTORY_PAGE_MAX, RELEASE_CARRY_MAX, releaseProblemText, releasePlanRefusalLines, workspaceProtectedText, historyKindChangesWorkspace, } from '@elaraai/e3-cloud-types';
+export type { RepositoryHistory, WorkspaceHistorySummary, WorkspaceHistoryApp, WorkspaceHistoryEntry, WorkspaceHistoryKind, WorkspaceHistoryOutcome, WorkspaceHistoryPage, ReleaseApp, ReleaseAppChange, ReleaseAppVersion, ReleaseCarry, ReleaseCarryKind, ReleasePlan, ReleaseProblem, ReleaseRequest, ReleaseResponse, ReleaseSource, RollbackRequest, WorkspaceReleaseSettings, RepositoryReleaseSettings, ReleaseUndone, StagingStart, StagingApp, StagingRuns, AddStagingRequest, StagingPlan, AddStagingResponse, StagingLink, } from '@elaraai/e3-cloud-types';
+export { adminAppList, repositoryAppList, appDeployWait, appList, myAppList, myAppRebuilds, appGet, appVersions, appUpload, appDeploy, appsDeploy, appRemove, type AdminAppListOptions, type AppDeployAsk, type AppsDeployAsk, type AppRemoveOptions, type AppDeployWaitOptions, type AppVersionsOptions, } from './apps.js';
+export { APP_VERSIONS_KEPT, APP_OBJECT_MAX_BYTES, APP_DEPLOY_MAX, appProblemText, appProblemLines, appProblemsText, appDeployRefusedText, } from '@elaraai/e3-cloud-types';
+export type { AdminAppPage, AppRebuilds, RepositoryApps, WorkspaceLastRelease, AppSummary, AppList, AppVersion, AppVersionPage, AppNav, AppStaged, AppSource, AppDeployRequest, AppsDeployRequest, AppDeployResponse, AppDeployKind, AppRemoved, AppProblem, AppProblems, } from '@elaraai/e3-cloud-types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -0,0 +1,67 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * e3-cloud-client: HTTP client library for e3 admin API
+ *
+ * This package provides a typed HTTP client for interacting with the e3 admin API,
+ * building on e3-api-client's HTTP utilities.
+ *
+ * Features:
+ * - Type-safe request/response handling using East types
+ * - BEAST2 binary serialization format
+ * - Exception-based error handling (throws ApiError on failures)
+ *
+ * @example
+ * ```typescript
+ * import { whoami, repoUsers, addUser, ApiError } from '@elaraai/e3-cloud-client';
+ * import { variant } from '@elaraai/east';
+ *
+ * const options = { token: accessToken };
+ *
+ * // Get current user
+ * const me = await whoami('https://e3.example.com', options);
+ *
+ * // Add a user holding the built-in All apps role
+ * try {
+ *   const user = await addUser(
+ *     'https://e3.example.com',
+ *     'my-repo',
+ *     { email: 'bob@example.com', role: variant('user', { roles: ['All apps'] }) },
+ *     options
+ *   );
+ * } catch (error) {
+ *   if (error instanceof ApiError) {
+ *     console.error(`Failed: ${error.code}`);
+ *   }
+ * }
+ * ```
+ */
+// Re-export HTTP utilities from e3-api-client
+export { ApiError, AuthError } from '@elaraai/e3-api-client';
+// API functions
+export { whoami, repoUsers, addUser, removeUser, repoInvitations, revokeRepoInvitation } from './users.js';
+export { getSchedule, setSchedule, removeSchedule, listSchedules } from './schedules.js';
+export { listCompute, getCompute, setCompute, setComputeBatch, removeCompute, listTimeout, getTimeout, setTimeout, setTimeoutBatch, removeTimeout, removeTimeoutBatch, listTaskConfigs, listDelegation, setDelegation, removeDelegation, listFunctionDelegation, setFunctionDelegation, removeFunctionDelegation, getWidth, setWidth, removeWidth, repositorySettings, } from './task-configs.js';
+export { getUserSettings, putUserSettings, deleteUserSettings } from './user-settings.js';
+export { listSecrets, putSecret, deleteSecret } from './secrets.js';
+export { listInvitations, revokeInvitation, isInvitedSentinel } from './invitations.js';
+export { listAdminUsers, disableUser, enableUser, lookupPeople } from './admin-users.js';
+export { myMemberships } from './me.js';
+// Business roles: a repository's roles, and what the caller's grant them
+export { listRoles, getRole, putRole, deleteRole, myAccess, previewRole } from './roles.js';
+export { getDelegationPolicy, setDelegationPolicy, getRackSecurityPolicy, setRackSecurityPolicy, listRacks, enrollRack, deregisterRack, rackActivity, approveRackBoot, ApproveBootRequestType, EnrollmentTokenType, } from './deployment-settings.js';
+// Record history, rollback & backups
+export { listRecordInfos, recordAudit, recordStateAt, recordStatePage, recordValueChunks, rollbackRecord, listRecordBackups, createRecordBackup, restoreRecordBackup, recordBackupDownload, recordBackupStream, recordBackupValue, deleteRecordBackup, } from './records.js';
+// Feedback on components
+export { getFeedbackSettings, putFeedbackSettings, addFeedback, listMyFeedback, listFeedback, getFeedback, feedbackScreenshotUrl, closeFeedback, reopenFeedback, } from './feedback.js';
+export { feedbackId, FEEDBACK_NOTE_MAX_CHARS, FEEDBACK_TEXT_MAX_CHARS, FEEDBACK_URL_MAX_CHARS, FEEDBACK_SHORT_MAX_CHARS, FEEDBACK_DATASETS_MAX, FEEDBACK_NOTE_MAX_BYTES, FEEDBACK_SCREENSHOT_MAX_BYTES, FEEDBACK_SCREENSHOT_TYPES, FEEDBACK_SUMMARY_CHARS, FEEDBACK_PAGE_DEFAULT, FEEDBACK_PAGE_MAX, } from '@elaraai/e3-cloud-types';
+// A workspace's history: its releases, rollbacks, deploys, app deploys
+// and copies; and its staging, which protects it
+export { workspaceHistory, workspaceHistoryEntry, repositoryHistory, releaseWorkspace, rollbackWorkspace, getReleaseSettings, getRepositoryReleaseSettings, addStaging, stopStaging, } from './history.js';
+export { WORKSPACE_HISTORY_PAGE_DEFAULT, WORKSPACE_HISTORY_PAGE_MAX, RELEASE_CARRY_MAX, releaseProblemText, releasePlanRefusalLines, workspaceProtectedText, historyKindChangesWorkspace, } from '@elaraai/e3-cloud-types';
+// Apps: a workspace's apps, an upload of an app object, deploys, versions and removal; yours across your repositories, and those to rebuild; a repository's and the deployment's
+export { adminAppList, repositoryAppList, appDeployWait, appList, myAppList, myAppRebuilds, appGet, appVersions, appUpload, appDeploy, appsDeploy, appRemove, } from './apps.js';
+export { APP_VERSIONS_KEPT, APP_OBJECT_MAX_BYTES, APP_DEPLOY_MAX, appProblemText, appProblemLines, appProblemsText, appDeployRefusedText, } from '@elaraai/e3-cloud-types';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/invitations.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+import { type InvitationList } from '@elaraai/e3-cloud-types';
+import { type RequestOptions } from '@elaraai/e3-api-client';
+/**
+ * List all invitations (admin only), newest first.
+ */
+export declare function listInvitations(url: string, options: RequestOptions): Promise<InvitationList>;
+/**
+ * Revoke a pending invitation (admin only). No-op on absent/claimed.
+ */
+export declare function revokeInvitation(url: string, email: string, options: RequestOptions): Promise<void>;
+/** Whether an add-user response denotes a recorded invitation (not yet a member). */
+export declare function isInvitedSentinel(userId: string): boolean;
+//# sourceMappingURL=invitations.d.ts.map

package/dist/src/invitations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invitations.d.ts","sourceRoot":"","sources":["../../src/invitations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEvE;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAEnG;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzG;AAED,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEzD"}