changelog.md

@@ -1,24 +0,0 @@
-# Changelog
-
-## 2024-08-27 - 1.1.0 - feat(core)
-Add delete user functionality and necessary tests
-
-- Implemented delete method in ZitadelUser class.
-- Extended tests to cover user deletion functionality.
-- Refactored createUser method to return a ZitadelUser instance.
-
-## 2024-08-26 - 1.0.9 - fix(dependencies)
-Update dependencies to latest versions
-
-- Updated @git.zone/tsbuild from ^2.1.25 to ^2.1.84
-- Updated @git.zone/tsrun from ^1.2.46 to ^1.2.49
-- Updated @push.rocks/tapbundle from ^5.0.15 to ^5.0.24
-- Updated @types/node from ^20.8.7 to ^22.5.0
-- Updated @tsclass/tsclass from ^4.0.54 to ^4.1.2
-- Updated @zitadel/node from ^2.0.8 to 2.0.17
-
-## 2024-05-02 to 2024-05-03 - 1.0.1 to 1.0.8 - Fixes and Updates
-General updates and fixes to the core functionality across multiple versions.
-
-- Various fixes in core functionality
-- Incremental improvements and updates

npmextra.json

@@ -5,7 +5,7 @@
       "githost": "code.foss.global",
       "gitscope": "apiclient.xyz",
       "gitrepo": "zitadel",
-      "description": "An unofficial client for interacting with Zitadel API, enabling user and project management functionalities.",
+      "description": "An unofficial client for interacting with Zitadel API.",
       "npmPackagename": "@apiclient.xyz/zitadel",
       "license": "MIT",
       "projectDomain": "apiclient.xyz",
@@ -14,12 +14,7 @@
         "API client",
         "TypeScript",
         "authentication",
-        "user management",
-        "project management",
-        "unofficial client",
-        "node.js",
-        "access control",
-        "software development"
+        "user management"
       ]
     }
   },

package.json

@@ -1,8 +1,8 @@
 {
   "name": "@apiclient.xyz/zitadel",
-  "version": "1.1.0",
+  "version": "1.0.6",
   "private": false,
-  "description": "An unofficial client for interacting with Zitadel API, enabling user and project management functionalities.",
+  "description": "An unofficial client for interacting with Zitadel API.",
   "main": "dist_ts/index.js",
   "typings": "dist_ts/index.d.ts",
   "type": "module",
@@ -14,17 +14,17 @@
     "buildDocs": "(tsdoc)"
   },
   "devDependencies": {
-    "@git.zone/tsbuild": "^2.1.84",
+    "@git.zone/tsbuild": "^2.1.25",
     "@git.zone/tsbundle": "^2.0.5",
-    "@git.zone/tsrun": "^1.2.49",
+    "@git.zone/tsrun": "^1.2.46",
     "@git.zone/tstest": "^1.0.44",
     "@push.rocks/qenv": "^6.0.5",
-    "@push.rocks/tapbundle": "^5.0.24",
-    "@types/node": "^22.5.0"
+    "@push.rocks/tapbundle": "^5.0.15",
+    "@types/node": "^20.8.7"
   },
   "dependencies": {
-    "@tsclass/tsclass": "^4.1.2",
-    "@zitadel/node": "2.0.17"
+    "@tsclass/tsclass": "^4.0.54",
+    "@zitadel/node": "^2.0.8"
   },
   "repository": {
     "type": "git",
@@ -54,11 +54,6 @@
     "API client",
     "TypeScript",
     "authentication",
-    "user management",
-    "project management",
-    "unofficial client",
-    "node.js",
-    "access control",
-    "software development"
+    "user management"
   ]
 }

readme.md

@@ -1,16 +1,15 @@
 # @apiclient.xyz/zitadel
-
-An unofficial client for interacting with Zitadel API.
+an unofficial zitadel client
 
 ## Install
 
-To get started with `@apiclient.xyz/zitadel`, ensure you have Node.js installed on your machine. Then, you can add this package to your project by running:
+To install `@apiclient.xyz/zitadel`, you need to have Node.js installed on your system. You can then add it to your project using npm with the following command:
 
 ```bash
 npm install @apiclient.xyz/zitadel --save
 ```
 
-This module is written in TypeScript to take advantage of type safety and autocompletion in IDEs. If you haven't installed TypeScript globally, you can do so by running:
+Ensure you have TypeScript installed for development purposes. If you haven't, install it using:
 
 ```bash
 npm install -g typescript
@@ -18,101 +17,91 @@ npm install -g typescript
 
 ## Usage
 
-The `@apiclient.xyz/zitadel` package provides an unofficial TypeScript client for easy interaction with Zitadel's API, allowing for convenient management operations such as user and project management.
+The `@apiclient.xyz/zitadel` package provides a simplified, unofficial TypeScript client for interacting with Zitadel's APIs. This guide will walk you through setting up the client and executing various operations such as user management in a TypeScript project.
 
-### Getting Started
+Let's get started by setting up and initializing the client in your project.
 
-First, ensure you import the core client class from the package:
+### Setup and Initialization
+
+First, import the necessary classes from the package:
 
 ```typescript
-import { ZitaldelClient } from '@apiclient.xyz/zitadel';
+import { ZitaldelClient, ZitaldelUser } from '@apiclient.xyz/zitadel';
 ```
 
-Initialize the `ZitaldelClient` with your Zitadel instance URL and access token:
+Instantiate the `ZitaldelClient` by providing connection options, including the Zitadel instance URL and an access token:
 
 ```typescript
 const zitadelClient = new ZitaldelClient({
-  url: 'https://your-zitadel-instance.com', // Replace with your Zitadel instance URL.
-  accessToken: 'your_access_token_here' // Replace with your actual access token.
+  url: 'https://your-zitadel-instance.com', // Replace with your Zitadel instance URL
+  accessToken: 'your_access_token_here' // Replace with your actual access token
 });
 ```
 
-### User Management
+### Managing Users
 
-The library allows performing user operations such as listing all users, getting info of the current user, and creating new users.
+The Zitadel client supports various user management operations such as listing users, getting user information, and creating new users.
 
-#### List All Users
+#### Listing Users
+
+To list users, you can use the `listUsers` method. This will return an array of `ZitaldelUser` objects:
 
 ```typescript
 async function listUsers() {
+  try {
     const users = await zitadelClient.listUsers();
-  console.log(users); // Outputs user list
+    console.log(users);
+  } catch (error) {
+    console.error('Failed to list users:', error);
+  }
 }
+
 listUsers();
 ```
 
-#### Get Current User Information
+#### Getting User Information
+
+To get information about a specific user, use the `listOwnUser` method. This method is handy for fetching details about the authenticated user:
 
 ```typescript
-async function getCurrentUser() {
+async function getOwnUserInfo() {
+  try {
     const user = await zitadelClient.listOwnUser();
-  console.log(user); // Outputs current user information.
+    console.log(user);
+  } catch (error) {
+    console.error('Failed to get user info:', error);
+  }
 }
-getCurrentUser();
+
+getOwnUserInfo();
 ```
 
-#### Create a New User
+#### Creating a User
+
+To create a new user, the `createUser` method can be used. You need to provide user details such as email, first name, and last name:
 
 ```typescript
 async function createUser() {
+  try {
     await zitadelClient.createUser({
       email: 'newuser@example.com',
-    firstName: 'First',
-    lastName: 'Last'
+      firstName: 'John',
+      lastName: 'Doe'
     });
-  console.log('User created successfully.');
+    console.log('User created successfully');
+  } catch (error) {
+    console.error('Failed to create user:', error);
+  }
 }
+
 createUser();
 ```
 
-### Project Management
+### Advanced Usage
 
-Beyond user management, the client also supports actions on projects—like listing and managing project roles.
+For more advanced scenarios, refer to the [official Zitadel documentation](https://docs.zitadel.ch/) and the source code of this package. The `@apiclient.xyz/zitadel` client provides a straightforward interface to Zitadel's API but does not cover all possible use cases and functionalities of Zitadel. You might need to extend the client or use the official Zitadel client for complex scenarios.
 
-#### List Projects
+## Conclusion
 
-```typescript
-async function listProjects() {
-  const projects = await zitadelClient.listProjects();
-  console.log(projects); // Outputs list of projects
-}
-listProjects();
-```
-
-#### Project Roles
-
-Each project comes with roles that can be managed through the client.
-
-##### Listing Project Roles
-
-To inspect roles within a project:
-
-```typescript
-async function listProjectRoles(projectId: string) {
-  const projectRoles = await someProject.listProjectRoles(); // Assume `someProject` is an instance of `ZitadelProject`.
-  console.log(projectRoles);
-}
-```
-
-Note: The `ZitadelProject` object would typically be obtained as part of the list from `listProjects`.
-
-### Advanced Topics
-
-For more complex scenarios, such as direct interaction with Zitadel's gRPC APIs, or detailed configuration, please refer to the comprehensive [official Zitadel documentation](https://docs.zitadel.ch/). This client offers a simplified abstraction over Zitadel's API functionalities but can be extended or used in conjunction with direct API calls to meet specific needs.
-
-For instance, the `ZitaldelClient` class can be tweaked to support custom interceptors for logging, authentication flow enhancements, or to integrate with Zitadel's event system for real-time updates on resources.
-
----
-
-This is a basic introduction to `@apiclient.xyz/zitadel`. The client simplifies the interaction with Zitadel's API, focusing on core functionalities like user and project management. For specific use cases, detailed configurations, or advanced features, you may need to extend the client or use it as a foundation for more complex interactions with the Zitadel API.
+The `@apiclient.xyz/zitadel` package makes it easier to interact with Zitadel's APIs from a TypeScript application. With it, you can manage users, handle authentication, and perform various other operations provided by Zitadel. This guide covered the basics of setting up the client, managing users, and performing some common operations. For further details or specific use cases, consult the Zitadel documentation and the package's source code.
 undefined

test/test.ts

@@ -24,24 +24,15 @@ tap.test('should list users', async () => {
   const users = await testZitadel.listUsers();
   expect(users).toBeArray();
   expect(users[0]).toBeInstanceOf(zitadel.ZitaldelUser);
-  console.log(JSON.stringify(users, null, 2));
+  console.log(users);
 })
 
-const createUserTest = tap.test('should invite user', async (toolsArg) => {
-  const user = await testZitadel.createUser({
+tap.test('should invite user', async () => {
+  await testZitadel.createUser({
     email: await testQenv.getEnvVarOnDemand('ZITADEL_TEST_EMAIL'),
     firstName: 'firstname',
     lastName: 'lastname',
   })
-  await toolsArg.delayFor(5000);
-  return user;
-})
-
-tap.test('should delete user', async () => {
-  const createdUser: zitadel.ZitaldelUser = (await createUserTest.testResultPromise) as any;
-  expect(createdUser).toBeInstanceOf(zitadel.ZitaldelUser);
-  await createdUser.delete();
-  
 })
 
 export default tap.start()

ts/00_commitinfo_data.ts

@@ -1,8 +1,8 @@
 /**
- * autocreated commitinfo by @push.rocks/commitinfo
+ * autocreated commitinfo by @pushrocks/commitinfo
  */
 export const commitinfo = {
   name: '@apiclient.xyz/zitadel',
-  version: '1.1.0',
-  description: 'An unofficial client for interacting with Zitadel API, enabling user and project management functionalities.'
+  version: '1.0.6',
+  description: 'An unofficial client for interacting with Zitadel API.'
 }

ts/classes.zitadelclient.ts

@@ -79,12 +79,6 @@ export class ZitaldelClient {
         familyName: optionsArg.lastName,
       }
     });
-    // const allUsers = await this.listUsers();
-    // console.log(JSON.stringify(allUsers, null, 2));
-    return new ZitaldelUser(this, {
-      id: response.userId,
-      lastLogin: null,
-      username: optionsArg.email,
-    });
+    console.log(response);
   }
 }

ts/classes.zitadeluser.ts

@@ -64,13 +64,4 @@ export class ZitaldelUser {
       userId: this.data.id,
     });
   }
-
-  /**
-   * deletes the user
-   */
-  public async delete() {
-    const response = await this.zitadelclientRef.userClient.deleteUser({
-      userId: this.data.id,
-    });
-  }
 }