@tak-ps/node-tak 12.29.0 → 12.31.0

package/CHANGELOG.md

@@ -12,9 +12,17 @@
 
 ### Pending
 
+### v12.31.0 - 2026-09-29
+
+- :tada: Add `MissionProperty` API module for TAK Server 5.9+ Mission key/value properties (`list` with optional `prefix`, `get`, `set` (upsert), `delete`, `deleteAll`)
+
+### v12.30.0 - 2026-09-04
+
+- :tada: Add `UserManagement` API module & `tak user-management` CLI command implementing the File User Account Management API (`createUser`, `createUsers`, `listUsers`, `userGroups`, `changePassword`, `updateUserGroups`, `updateGroupUsers`, `deleteUser`, `listGroups`, `groupUsers`)
+
 ### v12.29.0 - 2026-09-03
 
-- :tada: `Files.upload()` accepts an optional `uid` to set the UID metadata of the uploaded file, which TAK clients use to associate a Mission file with the map item of the same UID
+- :tada: `Files.upload()` accepts an optional `uid` to set the UID metadata of the uploaded file
 
 ### v12.28.0 - 2026-08-28
 

package/dist/lib/api/mission-property.d.ts

@@ -0,0 +1,65 @@
+import { Static } from '@sinclair/typebox';
+import type { MissionOptions } from './mission.js';
+import Commands from '../commands.js';
+export declare const MissionProperty: import("@sinclair/typebox").TObject<{
+    key: import("@sinclair/typebox").TString;
+    value: import("@sinclair/typebox").TString;
+}>;
+export declare const MissionPropertyListInput: import("@sinclair/typebox").TObject<{
+    prefix: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare const SetMissionProperty: import("@sinclair/typebox").TObject<{
+    key: import("@sinclair/typebox").TString;
+    value: import("@sinclair/typebox").TString;
+    creatorUid: import("@sinclair/typebox").TString;
+}>;
+export declare const TAKItem_MissionProperty: import("@sinclair/typebox").TObject<{
+    version: import("@sinclair/typebox").TString;
+    type: import("@sinclair/typebox").TString;
+    data: import("@sinclair/typebox").TObject<{
+        key: import("@sinclair/typebox").TString;
+        value: import("@sinclair/typebox").TString;
+    }>;
+    messages: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    nodeId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+export declare const TAKList_MissionProperty: import("@sinclair/typebox").TObject<{
+    version: import("@sinclair/typebox").TString;
+    type: import("@sinclair/typebox").TString;
+    data: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+        key: import("@sinclair/typebox").TString;
+        value: import("@sinclair/typebox").TString;
+    }>>;
+    messages: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    nodeId: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TString>;
+}>;
+/**
+ * Key/Value properties stored on a Mission Sync
+ *
+ * Requires TAK Server 5.9 or later
+ */
+export default class MissionPropertyCommands extends Commands {
+    #private;
+    schema: {};
+    cli(): Promise<object | string>;
+    /**
+     * List properties on a Mission Sync, optionally filtered by key prefix
+     */
+    list(mission: string, query?: Static<typeof MissionPropertyListInput>, opts?: Static<typeof MissionOptions>): Promise<Static<typeof TAKList_MissionProperty>>;
+    /**
+     * Get a single property on a Mission Sync
+     */
+    get(mission: string, key: string, opts?: Static<typeof MissionOptions>): Promise<Static<typeof TAKItem_MissionProperty>>;
+    /**
+     * Create or update (upsert) a property on a Mission Sync
+     */
+    set(mission: string, body: Static<typeof SetMissionProperty>, opts?: Static<typeof MissionOptions>): Promise<Static<typeof TAKItem_MissionProperty>>;
+    /**
+     * Delete a single property on a Mission Sync
+     */
+    delete(mission: string, key: string, creatorUid: string, opts?: Static<typeof MissionOptions>): Promise<void>;
+    /**
+     * Delete all properties on a Mission Sync
+     */
+    deleteAll(mission: string, creatorUid: string, opts?: Static<typeof MissionOptions>): Promise<void>;
+}

package/dist/lib/api/mission-property.js

@@ -0,0 +1,114 @@
+import { Type } from '@sinclair/typebox';
+import { TAKItem, TAKList } from './types.js';
+import Commands from '../commands.js';
+import { GUIDMatch } from './mission.js';
+export const MissionProperty = Type.Object({
+    key: Type.String(),
+    value: Type.String()
+});
+export const MissionPropertyListInput = Type.Object({
+    prefix: Type.Optional(Type.String({
+        description: 'Only return properties whose key starts with this prefix'
+    }))
+});
+export const SetMissionProperty = Type.Object({
+    key: Type.String(),
+    value: Type.String(),
+    creatorUid: Type.String()
+});
+export const TAKItem_MissionProperty = TAKItem(MissionProperty);
+export const TAKList_MissionProperty = TAKList(MissionProperty);
+/**
+ * Key/Value properties stored on a Mission Sync
+ *
+ * Requires TAK Server 5.9 or later
+ */
+export default class MissionPropertyCommands extends Commands {
+    schema = {};
+    async cli() {
+        throw new Error('Unsupported Subcommand');
+    }
+    #headers(opts) {
+        if (opts && opts.token) {
+            return {
+                MissionAuthorization: `Bearer ${opts.token}`
+            };
+        }
+        else {
+            return {};
+        }
+    }
+    /**
+     * Property endpoints are only exposed by GUID, resolve a Mission name if needed
+     */
+    async #guid(mission, opts) {
+        if (GUIDMatch.test(mission))
+            return mission;
+        return (await this.api.Mission.get(mission, {}, opts)).guid;
+    }
+    /**
+     * List properties on a Mission Sync, optionally filtered by key prefix
+     */
+    async list(mission, query = {}, opts) {
+        const guid = await this.#guid(mission, opts);
+        const url = new URL(`/Marti/api/missions/guid/${encodeURIComponent(guid)}/properties`, this.api.url);
+        if (query.prefix !== undefined)
+            url.searchParams.append('prefix', query.prefix);
+        return await this.api.fetch(url, {
+            method: 'GET',
+            headers: this.#headers(opts)
+        });
+    }
+    /**
+     * Get a single property on a Mission Sync
+     */
+    async get(mission, key, opts) {
+        const guid = await this.#guid(mission, opts);
+        const url = new URL(`/Marti/api/missions/guid/${encodeURIComponent(guid)}/properties/${encodeURIComponent(key)}`, this.api.url);
+        return await this.api.fetch(url, {
+            method: 'GET',
+            headers: this.#headers(opts)
+        });
+    }
+    /**
+     * Create or update (upsert) a property on a Mission Sync
+     */
+    async set(mission, body, opts) {
+        const guid = await this.#guid(mission, opts);
+        const url = new URL(`/Marti/api/missions/guid/${encodeURIComponent(guid)}/properties`, this.api.url);
+        url.searchParams.append('creatorUid', body.creatorUid);
+        return await this.api.fetch(url, {
+            method: 'PUT',
+            headers: this.#headers(opts),
+            body: {
+                key: body.key,
+                value: body.value
+            }
+        });
+    }
+    /**
+     * Delete a single property on a Mission Sync
+     */
+    async delete(mission, key, creatorUid, opts) {
+        const guid = await this.#guid(mission, opts);
+        const url = new URL(`/Marti/api/missions/guid/${encodeURIComponent(guid)}/properties/${encodeURIComponent(key)}`, this.api.url);
+        url.searchParams.append('creatorUid', creatorUid);
+        await this.api.fetch(url, {
+            method: 'DELETE',
+            headers: this.#headers(opts)
+        });
+    }
+    /**
+     * Delete all properties on a Mission Sync
+     */
+    async deleteAll(mission, creatorUid, opts) {
+        const guid = await this.#guid(mission, opts);
+        const url = new URL(`/Marti/api/missions/guid/${encodeURIComponent(guid)}/properties`, this.api.url);
+        url.searchParams.append('creatorUid', creatorUid);
+        await this.api.fetch(url, {
+            method: 'DELETE',
+            headers: this.#headers(opts)
+        });
+    }
+}
+//# sourceMappingURL=mission-property.js.map

package/dist/lib/api/mission-property.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-property.js","sourceRoot":"","sources":["../../../lib/api/mission-property.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAU,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC;IACvC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,IAAI,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAC9B,WAAW,EAAE,0DAA0D;KAC1E,CAAC,CAAC;CACN,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC1C,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE;IACpB,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,uBAAuB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAwB,SAAQ,QAAQ;IACzD,MAAM,GAAG,EAAE,CAAA;IAEX,KAAK,CAAC,GAAG;QACL,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC9C,CAAC;IAED,QAAQ,CAAC,IAAoC;QACzC,IAAI,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO;gBACH,oBAAoB,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;aAC/C,CAAA;QACL,CAAC;aAAM,CAAC;YACJ,OAAO,EAAE,CAAC;QACd,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CACP,OAAe,EACf,IAAoC;QAEpC,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;YAAE,OAAO,OAAO,CAAC;QAE5C,OAAO,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CACN,OAAe,EACf,QAAiD,EAAE,EACnD,IAAoC;QAEpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,4BAA4B,kBAAkB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAErG,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAEhF,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE;YAC7B,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;SAC/B,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CACL,OAAe,EACf,GAAW,EACX,IAAoC;QAEpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,4BAA4B,kBAAkB,CAAC,IAAI,CAAC,eAAe,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAEhI,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE;YAC7B,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;SAC/B,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CACL,OAAe,EACf,IAAuC,EACvC,IAAoC;QAEpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,4BAA4B,kBAAkB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEvD,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE;YAC7B,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC5B,IAAI,EAAE;gBACF,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,KAAK,EAAE,IAAI,CAAC,KAAK;aACpB;SACJ,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CACR,OAAe,EACf,GAAW,EACX,UAAkB,EAClB,IAAoC;QAEpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,4BAA4B,kBAAkB,CAAC,IAAI,CAAC,eAAe,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChI,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAElD,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE;YACtB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;SAC/B,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CACX,OAAe,EACf,UAAkB,EAClB,IAAoC;QAEpC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,4BAA4B,kBAAkB,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrG,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;QAElD,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE;YACtB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;SAC/B,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/lib/api/user-management.d.ts

@@ -0,0 +1,168 @@
+import { Static } from '@sinclair/typebox';
+import Commands, { CommandOutputFormat, type ParsedArgs } from '../commands.js';
+export declare const UserManagementUsername: import("@sinclair/typebox").TObject<{
+    username: import("@sinclair/typebox").TString;
+}>;
+export declare const UserManagementGroupName: import("@sinclair/typebox").TObject<{
+    groupname: import("@sinclair/typebox").TString;
+}>;
+export declare const UserManagementNewUser: import("@sinclair/typebox").TObject<{
+    groupList: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    groupListIN: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    groupListOUT: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    username: import("@sinclair/typebox").TString;
+    password: import("@sinclair/typebox").TString;
+}>;
+export declare const UserManagementBulkUsers: import("@sinclair/typebox").TObject<{
+    groupList: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    groupListIN: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    groupListOUT: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    usernameExpression: import("@sinclair/typebox").TString;
+    startN: import("@sinclair/typebox").TInteger;
+    endN: import("@sinclair/typebox").TInteger;
+}>;
+export declare const UserManagementUserPassword: import("@sinclair/typebox").TObject<{
+    username: import("@sinclair/typebox").TString;
+    password: import("@sinclair/typebox").TString;
+}>;
+export declare const UserManagementUserGroups: import("@sinclair/typebox").TObject<{
+    groupList: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    groupListIN: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    groupListOUT: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    username: import("@sinclair/typebox").TString;
+}>;
+export declare const UserManagementGroupUsers: import("@sinclair/typebox").TObject<{
+    groupname: import("@sinclair/typebox").TString;
+    usersInGroupList: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    usersInGroupListIN: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+    usersInGroupListOUT: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>>;
+}>;
+export declare const UserManagementList_Username: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+    username: import("@sinclair/typebox").TString;
+}>>;
+export declare const UserManagementList_GroupName: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+    groupname: import("@sinclair/typebox").TString;
+}>>;
+export declare const UserManagementList_UserPassword: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+    username: import("@sinclair/typebox").TString;
+    password: import("@sinclair/typebox").TString;
+}>>;
+export declare const UserManagementUserGroupsResponse: import("@sinclair/typebox").TObject<{
+    username: import("@sinclair/typebox").TString;
+    groupList: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    groupListIN: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    groupListOUT: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+}>;
+export declare const UserManagementGroupUsersResponse: import("@sinclair/typebox").TObject<{
+    groupname: import("@sinclair/typebox").TString;
+    usersInGroupList: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    usersInGroupListIN: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    usersInGroupListOUT: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+}>;
+/**
+ * Manage File (non-LDAP) User Accounts on TAK Server
+ *
+ * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api TAK Server Docs}.
+ */
+export default class UserManagementCommands extends Commands {
+    schema: {
+        'list-users': {
+            description: string;
+            params: import("@sinclair/typebox").TObject<{}>;
+            query: import("@sinclair/typebox").TObject<{}>;
+            formats: CommandOutputFormat[];
+        };
+        'list-groups': {
+            description: string;
+            params: import("@sinclair/typebox").TObject<{}>;
+            query: import("@sinclair/typebox").TObject<{}>;
+            formats: CommandOutputFormat[];
+        };
+        'user-groups': {
+            description: string;
+            params: import("@sinclair/typebox").TObject<{
+                username: import("@sinclair/typebox").TString;
+            }>;
+            query: import("@sinclair/typebox").TObject<{}>;
+            formats: CommandOutputFormat[];
+        };
+        'group-users': {
+            description: string;
+            params: import("@sinclair/typebox").TObject<{
+                group: import("@sinclair/typebox").TString;
+            }>;
+            query: import("@sinclair/typebox").TObject<{}>;
+            formats: CommandOutputFormat[];
+        };
+        'delete-user': {
+            description: string;
+            params: import("@sinclair/typebox").TObject<{
+                username: import("@sinclair/typebox").TString;
+            }>;
+            query: import("@sinclair/typebox").TObject<{}>;
+            formats: CommandOutputFormat[];
+        };
+    };
+    cli(args: ParsedArgs): Promise<object | string>;
+    /**
+     * Create a new File User
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/createOrUpdateFileUser TAK Server Docs}.
+     */
+    createUser(user: Static<typeof UserManagementNewUser>): Promise<void>;
+    /**
+     * Create File Users in bulk from a username expression containing `[N]`
+     * Passwords are generated by the server and only returned once
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/createFileUsersInBulk TAK Server Docs}.
+     */
+    createUsers(bulk: Static<typeof UserManagementBulkUsers>): Promise<Static<typeof UserManagementList_UserPassword>>;
+    /**
+     * List all File Users
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/getAllUsers_3 TAK Server Docs}.
+     */
+    listUsers(): Promise<Static<typeof UserManagementList_Username>>;
+    /**
+     * Get the Groups associated with a File User
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/getGroupsForUsers TAK Server Docs}.
+     */
+    userGroups(username: string): Promise<Static<typeof UserManagementUserGroupsResponse>>;
+    /**
+     * Change the password of a File User
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/changeUserPassword TAK Server Docs}.
+     */
+    changePassword(user: Static<typeof UserManagementUserPassword>): Promise<void>;
+    /**
+     * Replace the Groups associated with a File User
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/updateGroupsForUser TAK Server Docs}.
+     */
+    updateUserGroups(user: Static<typeof UserManagementUserGroups>): Promise<void>;
+    /**
+     * Replace the File Users associated with a Group
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/updateUsersForGroup TAK Server Docs}.
+     */
+    updateGroupUsers(group: Static<typeof UserManagementGroupUsers>): Promise<void>;
+    /**
+     * Delete a File User
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/deleteUser_1 TAK Server Docs}.
+     */
+    deleteUser(username: string): Promise<void>;
+    /**
+     * List all Group Names used by File Users
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/getAllGroupNames TAK Server Docs}.
+     */
+    listGroups(): Promise<Static<typeof UserManagementList_GroupName>>;
+    /**
+     * Get the File Users in a Group along with their IN/OUT/BOTH direction
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/getUsersInGroup TAK Server Docs}.
+     */
+    groupUsers(group: string): Promise<Static<typeof UserManagementGroupUsersResponse>>;
+}

package/dist/lib/api/user-management.js

@@ -0,0 +1,296 @@
+import { Type } from '@sinclair/typebox';
+import Commands, { CommandOutputFormat } from '../commands.js';
+const GroupLists = {
+    groupList: Type.Optional(Type.Array(Type.String())),
+    groupListIN: Type.Optional(Type.Array(Type.String())),
+    groupListOUT: Type.Optional(Type.Array(Type.String()))
+};
+export const UserManagementUsername = Type.Object({
+    username: Type.String()
+});
+export const UserManagementGroupName = Type.Object({
+    groupname: Type.String()
+});
+export const UserManagementNewUser = Type.Object({
+    username: Type.String(),
+    password: Type.String(),
+    ...GroupLists
+});
+export const UserManagementBulkUsers = Type.Object({
+    usernameExpression: Type.String({ description: 'Username pattern containing [N] which is replaced by each integer from startN to endN' }),
+    startN: Type.Integer(),
+    endN: Type.Integer(),
+    ...GroupLists
+});
+export const UserManagementUserPassword = Type.Object({
+    username: Type.String(),
+    password: Type.String()
+});
+export const UserManagementUserGroups = Type.Object({
+    username: Type.String(),
+    ...GroupLists
+});
+export const UserManagementGroupUsers = Type.Object({
+    groupname: Type.String(),
+    usersInGroupList: Type.Optional(Type.Array(Type.String())),
+    usersInGroupListIN: Type.Optional(Type.Array(Type.String())),
+    usersInGroupListOUT: Type.Optional(Type.Array(Type.String()))
+});
+export const UserManagementList_Username = Type.Array(UserManagementUsername);
+export const UserManagementList_GroupName = Type.Array(UserManagementGroupName);
+export const UserManagementList_UserPassword = Type.Array(UserManagementUserPassword);
+export const UserManagementUserGroupsResponse = Type.Object({
+    username: Type.String(),
+    groupList: Type.Array(Type.String()),
+    groupListIN: Type.Array(Type.String()),
+    groupListOUT: Type.Array(Type.String())
+});
+export const UserManagementGroupUsersResponse = Type.Object({
+    groupname: Type.String(),
+    usersInGroupList: Type.Array(Type.String()),
+    usersInGroupListIN: Type.Array(Type.String()),
+    usersInGroupListOUT: Type.Array(Type.String())
+});
+/**
+ * Manage File (non-LDAP) User Accounts on TAK Server
+ *
+ * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api TAK Server Docs}.
+ */
+export default class UserManagementCommands extends Commands {
+    schema = {
+        'list-users': {
+            description: 'List File Users',
+            params: Type.Object({}),
+            query: Type.Object({}),
+            formats: [CommandOutputFormat.JSON]
+        },
+        'list-groups': {
+            description: 'List Group Names used by File Users',
+            params: Type.Object({}),
+            query: Type.Object({}),
+            formats: [CommandOutputFormat.JSON]
+        },
+        'user-groups': {
+            description: 'List Groups for a given File User',
+            params: Type.Object({ username: Type.String() }),
+            query: Type.Object({}),
+            formats: [CommandOutputFormat.JSON]
+        },
+        'group-users': {
+            description: 'List File Users in a given Group',
+            params: Type.Object({ group: Type.String() }),
+            query: Type.Object({}),
+            formats: [CommandOutputFormat.JSON]
+        },
+        'delete-user': {
+            description: 'Delete a File User',
+            params: Type.Object({ username: Type.String() }),
+            query: Type.Object({}),
+            formats: [CommandOutputFormat.JSON]
+        }
+    };
+    async cli(args) {
+        if (args._[3] === 'list-users') {
+            const list = await this.listUsers();
+            if (args.format === 'json') {
+                return list;
+            }
+            else {
+                return list.map((user) => user.username).join('\n');
+            }
+        }
+        else if (args._[3] === 'list-groups') {
+            const list = await this.listGroups();
+            if (args.format === 'json') {
+                return list;
+            }
+            else {
+                return list.map((group) => group.groupname).join('\n');
+            }
+        }
+        else if (args._[3] === 'user-groups') {
+            if (!args._[4])
+                throw new Error('username must be provided');
+            const user = await this.userGroups(args._[4]);
+            if (args.format === 'json') {
+                return user;
+            }
+            else {
+                return [
+                    `${user.username}`,
+                    `  BOTH: ${user.groupList.join(', ')}`,
+                    `  IN:   ${user.groupListIN.join(', ')}`,
+                    `  OUT:  ${user.groupListOUT.join(', ')}`
+                ].join('\n');
+            }
+        }
+        else if (args._[3] === 'group-users') {
+            if (!args._[4])
+                throw new Error('group must be provided');
+            const group = await this.groupUsers(args._[4]);
+            if (args.format === 'json') {
+                return group;
+            }
+            else {
+                return [
+                    `${group.groupname}`,
+                    `  BOTH: ${group.usersInGroupList.join(', ')}`,
+                    `  IN:   ${group.usersInGroupListIN.join(', ')}`,
+                    `  OUT:  ${group.usersInGroupListOUT.join(', ')}`
+                ].join('\n');
+            }
+        }
+        else if (args._[3] === 'delete-user') {
+            if (!args._[4])
+                throw new Error('username must be provided');
+            await this.deleteUser(args._[4]);
+            return `Deleted ${args._[4]}`;
+        }
+        else {
+            throw new Error('Unsupported Subcommand');
+        }
+    }
+    /**
+     * Create a new File User
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/createOrUpdateFileUser TAK Server Docs}.
+     */
+    async createUser(user) {
+        const url = new URL('/Marti/api/user-management/api/new-user', this.api.url);
+        await this.api.fetch(url, {
+            method: 'POST',
+            body: {
+                username: user.username,
+                password: user.password,
+                groupList: user.groupList ?? [],
+                groupListIN: user.groupListIN ?? [],
+                groupListOUT: user.groupListOUT ?? []
+            }
+        });
+    }
+    /**
+     * Create File Users in bulk from a username expression containing `[N]`
+     * Passwords are generated by the server and only returned once
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/createFileUsersInBulk TAK Server Docs}.
+     */
+    async createUsers(bulk) {
+        const url = new URL('/Marti/api/user-management/api/new-users', this.api.url);
+        return await this.api.fetch(url, {
+            method: 'POST',
+            body: {
+                usernameExpression: bulk.usernameExpression,
+                startN: bulk.startN,
+                endN: bulk.endN,
+                groupList: bulk.groupList ?? [],
+                groupListIN: bulk.groupListIN ?? [],
+                groupListOUT: bulk.groupListOUT ?? []
+            }
+        });
+    }
+    /**
+     * List all File Users
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/getAllUsers_3 TAK Server Docs}.
+     */
+    async listUsers() {
+        const url = new URL('/Marti/api/user-management/api/list-users', this.api.url);
+        return await this.api.fetch(url, {
+            method: 'GET'
+        });
+    }
+    /**
+     * Get the Groups associated with a File User
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/getGroupsForUsers TAK Server Docs}.
+     */
+    async userGroups(username) {
+        const url = new URL(`/Marti/api/user-management/api/get-groups-for-user/${encodeURIComponent(username)}`, this.api.url);
+        return await this.api.fetch(url, {
+            method: 'GET'
+        });
+    }
+    /**
+     * Change the password of a File User
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/changeUserPassword TAK Server Docs}.
+     */
+    async changePassword(user) {
+        const url = new URL('/Marti/api/user-management/api/change-user-password', this.api.url);
+        await this.api.fetch(url, {
+            method: 'PUT',
+            body: {
+                username: user.username,
+                password: user.password
+            }
+        });
+    }
+    /**
+     * Replace the Groups associated with a File User
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/updateGroupsForUser TAK Server Docs}.
+     */
+    async updateUserGroups(user) {
+        const url = new URL('/Marti/api/user-management/api/update-groups', this.api.url);
+        await this.api.fetch(url, {
+            method: 'PUT',
+            body: {
+                username: user.username,
+                groupList: user.groupList ?? [],
+                groupListIN: user.groupListIN ?? [],
+                groupListOUT: user.groupListOUT ?? []
+            }
+        });
+    }
+    /**
+     * Replace the File Users associated with a Group
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/updateUsersForGroup TAK Server Docs}.
+     */
+    async updateGroupUsers(group) {
+        const url = new URL('/Marti/api/user-management/api/update-group-users', this.api.url);
+        await this.api.fetch(url, {
+            method: 'PUT',
+            body: {
+                groupname: group.groupname,
+                usersInGroupList: group.usersInGroupList ?? [],
+                usersInGroupListIN: group.usersInGroupListIN ?? [],
+                usersInGroupListOUT: group.usersInGroupListOUT ?? []
+            }
+        });
+    }
+    /**
+     * Delete a File User
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/deleteUser_1 TAK Server Docs}.
+     */
+    async deleteUser(username) {
+        const url = new URL(`/Marti/api/user-management/api/delete-user/${encodeURIComponent(username)}`, this.api.url);
+        await this.api.fetch(url, {
+            method: 'DELETE'
+        });
+    }
+    /**
+     * List all Group Names used by File Users
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/getAllGroupNames TAK Server Docs}.
+     */
+    async listGroups() {
+        const url = new URL('/Marti/api/user-management/api/list-groupnames', this.api.url);
+        return await this.api.fetch(url, {
+            method: 'GET'
+        });
+    }
+    /**
+     * Get the File Users in a Group along with their IN/OUT/BOTH direction
+     *
+     * {@link https://docs.tak.gov/api/takserver#tag/file-user-account-management-api/operation/getUsersInGroup TAK Server Docs}.
+     */
+    async groupUsers(group) {
+        const url = new URL(`/Marti/api/user-management/api/users-in-group/${encodeURIComponent(group)}`, this.api.url);
+        return await this.api.fetch(url, {
+            method: 'GET'
+        });
+    }
+}
+//# sourceMappingURL=user-management.js.map