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

package/dist/src/users.js

@@ -0,0 +1,100 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Licensed under BSL 1.1. See LICENSE for details.
+ */
+/**
+ * User management API functions using BEAST2 format.
+ */
+import { ArrayType, NullType } from '@elaraai/east';
+import { RepoUserType, RepoInvitationListType, WhoamiResponseType, AddUserRequestType, } from '@elaraai/e3-cloud-types';
+import { get, post, del } from '@elaraai/e3-api-client';
+/**
+ * Get current user info.
+ *
+ * @param url - The base URL of the e3 server (e.g., 'https://e3.example.com')
+ * @param options - Request options including authentication token
+ * @returns The current user's identity and admin status
+ * @throws {ApiError} On application-level errors
+ * @throws {AuthError} On 401 Unauthorized
+ */
+export async function whoami(url, options) {
+    return get(url, `/whoami`, WhoamiResponseType, options);
+}
+/**
+ * List users with access to a repository.
+ *
+ * Requires: owner role on the repository.
+ *
+ * @param url - The base URL of the e3 server
+ * @param repo - The repository name
+ * @param options - Request options including authentication token
+ * @returns List of users with access to the repository
+ * @throws {ApiError} On application-level errors
+ * @throws {AuthError} On 401 Unauthorized
+ */
+export async function repoUsers(url, repo, options) {
+    return get(url, `/repos/${encodeURIComponent(repo)}/users`, ArrayType(RepoUserType), options);
+}
+/**
+ * Add a user to a repository.
+ *
+ * Requires: owner role on the repository.
+ *
+ * @param url - The base URL of the e3 server
+ * @param repo - The repository name
+ * @param request - The add user request containing email and role
+ * @param options - Request options including authentication token
+ * @returns The newly added user
+ * @throws {ApiError} On application-level errors (e.g., user_not_found, forbidden)
+ * @throws {AuthError} On 401 Unauthorized
+ */
+export async function addUser(url, repo, request, options) {
+    return post(url, `/repos/${encodeURIComponent(repo)}/users`, request, AddUserRequestType, RepoUserType, options);
+}
+/**
+ * Remove a user from a repository.
+ *
+ * Requires: owner role on the repository.
+ *
+ * @param url - The base URL of the e3 server
+ * @param repo - The repository name
+ * @param userId - The user ID to remove
+ * @param options - Request options including authentication token
+ * @throws {ApiError} On application-level errors (e.g., forbidden, last_owner)
+ * @throws {AuthError} On 401 Unauthorized
+ */
+export async function removeUser(url, repo, userId, options) {
+    await del(url, `/repos/${encodeURIComponent(repo)}/users/${encodeURIComponent(userId)}`, NullType, options);
+}
+/**
+ * The people added to a repository who have not signed in yet: its pending
+ * invitations, each with the role its claim gives. Owner or admin.
+ * Their roles change as any person's do, by adding them again (`addUser`
+ * upserts an invitation's grant).
+ *
+ * @param url - The base URL of the e3 server
+ * @param repo - The repository name
+ * @param options - Request options including authentication token
+ * @returns The invitations, newest first
+ * @throws {ApiError} On application-level errors (e.g., forbidden)
+ * @throws {AuthError} On 401 Unauthorized
+ */
+export async function repoInvitations(url, repo, options) {
+    return get(url, `/repos/${encodeURIComponent(repo)}/invitations`, RepoInvitationListType, options);
+}
+/**
+ * Takes a repository's grant out of a pending invitation: someone added who
+ * has not signed in yet gets no access to it at their first sign-in.
+ * Owner or admin.
+ *
+ * @param url - The base URL of the e3 server
+ * @param repo - The repository name
+ * @param email - The invitee's email
+ * @param options - Request options including authentication token
+ * @throws {ApiError} On application-level errors (e.g., forbidden, user_not_found for no pending invitation)
+ * @throws {AuthError} On 401 Unauthorized
+ */
+export async function revokeRepoInvitation(url, repo, email, options) {
+    await del(url, `/repos/${encodeURIComponent(repo)}/invitations/${encodeURIComponent(email)}`, NullType, options);
+}
+//# sourceMappingURL=users.js.map

package/dist/src/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/users.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EACL,YAAY,EACZ,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,GAKnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAuB,MAAM,wBAAwB,CAAC;AAE7E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,GAAW,EACX,OAAuB;IAEvB,OAAO,GAAG,CAAC,GAAG,EAAE,SAAS,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,IAAY,EACZ,OAAuB;IAEvB,OAAO,GAAG,CACR,GAAG,EACH,UAAU,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAC1C,SAAS,CAAC,YAAY,CAAC,EACvB,OAAO,CACR,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAW,EACX,IAAY,EACZ,OAAuB,EACvB,OAAuB;IAEvB,OAAO,IAAI,CACT,GAAG,EACH,UAAU,kBAAkB,CAAC,IAAI,CAAC,QAAQ,EAC1C,OAAO,EACP,kBAAkB,EAClB,YAAY,EACZ,OAAO,CACR,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,IAAY,EACZ,MAAc,EACd,OAAuB;IAEvB,MAAM,GAAG,CACP,GAAG,EACH,UAAU,kBAAkB,CAAC,IAAI,CAAC,UAAU,kBAAkB,CAAC,MAAM,CAAC,EAAE,EACxE,QAAQ,EACR,OAAO,CACR,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW,EAAE,IAAY,EAAE,OAAuB;IACtF,OAAO,GAAG,CAAC,GAAG,EAAE,UAAU,kBAAkB,CAAC,IAAI,CAAC,cAAc,EAAE,sBAAsB,EAAE,OAAO,CAAC,CAAC;AACrG,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,GAAW,EAAE,IAAY,EAAE,KAAa,EAAE,OAAuB;IAC1G,MAAM,GAAG,CAAC,GAAG,EAAE,UAAU,kBAAkB,CAAC,IAAI,CAAC,gBAAgB,kBAAkB,CAAC,KAAK,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;AACnH,CAAC"}

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "@elaraai/e3-cloud-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "1.0.89-alpha.0",
+  "type": "module",
+  "description": "HTTP client library for the e3 cloud API",
+  "license": "BUSL-1.1",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "dependencies": {
+    "@elaraai/e3-api-client": "1.0.89",
+    "@elaraai/e3-types": "1.0.89",
+    "@elaraai/e3-cloud-types": "1.0.89-alpha.0"
+  },
+  "peerDependencies": {
+    "@elaraai/east": "1.0.89"
+  },
+  "files": [
+    "dist/src",
+    "!dist/src/**/*.spec.*",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
 }