@unisource/sdk 0.1.2 → 0.2.0

package/dist/index.mjs

@@ -1,9 +1,8 @@
 import { z } from "zod";
-//#region src/index.ts
-const FILES_DEFAULT_LIMIT = 25;
-const FILES_MAX_LIMIT = 100;
-const nonEmptyStringSchema = z.string().trim().min(1);
-const positiveIntegerSchema = z.number().int().positive();
+//#region src/primitives.ts
+const nonEmptyString = z.string().trim().min(1);
+const positiveInt = z.number().int().positive();
+const unixTimestamp = z.number().int().nonnegative();
 const uploadDestinationSchema = z.enum(["r2", "appwrite"]);
 const uploadStatusSchema = z.enum([
 	"pending",
@@ -11,84 +10,306 @@ const uploadStatusSchema = z.enum([
 	"failed"
 ]);
 const apiErrorSchema = z.object({
-	error: nonEmptyStringSchema,
-	message: nonEmptyStringSchema
+	error: nonEmptyString,
+	message: nonEmptyString
 });
+//#endregion
+//#region src/uploads.ts
 const uploadR2InitRequestSchema = z.object({
-	filename: nonEmptyStringSchema,
-	size: positiveIntegerSchema,
-	mime_type: nonEmptyStringSchema,
-	bucket: nonEmptyStringSchema.optional()
+	filename: nonEmptyString,
+	size: positiveInt,
+	mime_type: nonEmptyString
 });
 const uploadR2InitResponseSchema = z.object({
-	upload_id: nonEmptyStringSchema,
+	upload_id: nonEmptyString,
 	destination: z.literal("r2"),
 	presigned_url: z.string().url(),
-	storage_key: nonEmptyStringSchema,
-	bucket: nonEmptyStringSchema,
-	expires_at: positiveIntegerSchema
+	storage_key: nonEmptyString,
+	bucket: nonEmptyString,
+	expires_at: positiveInt
 });
 const uploadAppwriteInitRequestSchema = z.object({
-	filename: nonEmptyStringSchema,
-	size: positiveIntegerSchema,
-	mime_type: nonEmptyStringSchema
+	filename: nonEmptyString,
+	size: positiveInt,
+	mime_type: nonEmptyString
 });
 const uploadAppwriteInitResponseSchema = z.object({
-	upload_id: nonEmptyStringSchema,
+	upload_id: nonEmptyString,
 	destination: z.literal("appwrite"),
 	appwrite_endpoint: z.string().url(),
-	appwrite_project_id: nonEmptyStringSchema,
-	appwrite_bucket_id: nonEmptyStringSchema,
-	file_id: nonEmptyStringSchema,
-	expires_at: positiveIntegerSchema
+	appwrite_project_id: nonEmptyString,
+	appwrite_bucket_id: nonEmptyString,
+	file_id: nonEmptyString,
+	expires_at: positiveInt
 });
-const uploadLifecycleRequestSchema = z.object({ upload_id: nonEmptyStringSchema });
+const uploadLifecycleRequestSchema = z.object({ upload_id: nonEmptyString });
 const uploadCompleteResponseSchema = z.object({
 	success: z.literal(true),
-	upload_id: nonEmptyStringSchema,
+	upload_id: nonEmptyString,
 	status: z.literal("completed")
 });
 const uploadFailResponseSchema = z.object({
 	success: z.literal(true),
-	upload_id: nonEmptyStringSchema,
+	upload_id: nonEmptyString,
 	status: z.literal("failed")
 });
-const fileRecordSchema = z.object({
-	id: nonEmptyStringSchema,
-	filename: nonEmptyStringSchema,
-	size: positiveIntegerSchema,
-	mime_type: nonEmptyStringSchema,
+const FILES_DEFAULT_LIMIT = 25;
+const FILES_MAX_LIMIT = 100;
+/** Raw upload record — returned by admin `/files` endpoints. */
+const uploadRecordSchema = z.object({
+	id: nonEmptyString,
+	service_id: nonEmptyString,
+	user_id: nonEmptyString.nullable(),
+	filename: nonEmptyString,
+	size: positiveInt,
+	mime_type: nonEmptyString,
 	destination: uploadDestinationSchema,
-	storage_key: nonEmptyStringSchema,
-	bucket: nonEmptyStringSchema,
-	status: uploadStatusSchema,
-	expires_at: positiveIntegerSchema,
-	created_at: positiveIntegerSchema,
-	updated_at: positiveIntegerSchema
-});
-const filesListQuerySchema = z.object({
-	limit: z.number().int().min(1).max(100).optional(),
-	cursor: nonEmptyStringSchema.optional(),
-	destination: uploadDestinationSchema.optional(),
-	status: uploadStatusSchema.optional()
-});
-const filesListResponseSchema = z.object({
+	status: z.enum([
+		"pending",
+		"completed",
+		"failed"
+	]),
+	expires_at: positiveInt,
+	created_at: positiveInt,
+	updated_at: positiveInt
+});
+const uploadsListResponseSchema = z.object({
+	items: z.array(uploadRecordSchema),
+	next_cursor: z.string().nullable(),
+	limit: positiveInt
+});
+//#endregion
+//#region src/fileRecords.ts
+/**
+* A confirmed file record owned by a user.
+* Internal fields (storage_key, bucket) are intentionally excluded from the public API.
+*/
+const fileRecordSchema = z.object({
+	id: nonEmptyString,
+	service_id: nonEmptyString,
+	user_id: nonEmptyString,
+	folder_id: nonEmptyString.nullable(),
+	upload_id: nonEmptyString.nullable(),
+	filename: nonEmptyString,
+	size: positiveInt,
+	mime_type: nonEmptyString,
+	storage_destination: uploadDestinationSchema,
+	is_trashed: z.boolean(),
+	trashed_at: positiveInt.nullable(),
+	created_at: positiveInt,
+	updated_at: positiveInt
+});
+const fileRecordsListQuerySchema = z.object({
+	folder_id: nonEmptyString.nullable().optional(),
+	is_trashed: z.boolean().optional(),
+	cursor: nonEmptyString.optional(),
+	limit: z.number().int().min(1).max(100).optional()
+});
+const fileRecordsListResponseSchema = z.object({
 	items: z.array(fileRecordSchema),
 	next_cursor: z.string().nullable(),
-	limit: z.number().int().min(1).max(100)
+	limit: positiveInt
 });
-const fileDetailsResponseSchema = z.object({ file: fileRecordSchema });
+const fileRecordDetailResponseSchema = z.object({ file: fileRecordSchema });
+const fileMoveRequestSchema = z.object({ folder_id: nonEmptyString.nullable().optional() });
 const fileDownloadUrlResponseSchema = z.object({
-	upload_id: nonEmptyStringSchema,
+	upload_id: nonEmptyString,
 	destination: uploadDestinationSchema,
 	download_url: z.string().url(),
-	expires_at: positiveIntegerSchema
+	expires_at: positiveInt
 });
 const fileDeleteResponseSchema = z.object({
 	success: z.literal(true),
-	upload_id: nonEmptyStringSchema,
-	destination: uploadDestinationSchema,
-	storage_not_found: z.boolean()
+	id: nonEmptyString,
+	permanent: z.boolean()
+});
+const fileRestoreResponseSchema = z.object({
+	success: z.literal(true),
+	id: nonEmptyString
+});
+//#endregion
+//#region src/folders.ts
+const folderSchema = z.object({
+	id: nonEmptyString,
+	service_id: nonEmptyString,
+	user_id: nonEmptyString,
+	parent_id: nonEmptyString.nullable(),
+	name: nonEmptyString,
+	color_tag: z.string().nullable(),
+	is_trashed: z.boolean(),
+	trashed_at: positiveInt.nullable(),
+	created_at: positiveInt,
+	updated_at: positiveInt
 });
+const folderListQuerySchema = z.object({
+	parent_id: nonEmptyString.nullable().optional(),
+	is_trashed: z.boolean().optional(),
+	cursor: nonEmptyString.optional(),
+	limit: z.number().int().min(1).max(100).optional()
+});
+const folderListResponseSchema = z.object({
+	items: z.array(folderSchema),
+	next_cursor: z.string().nullable(),
+	limit: positiveInt
+});
+const folderCreateRequestSchema = z.object({
+	name: nonEmptyString,
+	parent_id: nonEmptyString.optional(),
+	color_tag: z.string().optional()
+});
+const folderCreateResponseSchema = z.object({ folder: folderSchema });
+const folderUpdateRequestSchema = z.object({
+	name: nonEmptyString.optional(),
+	color_tag: z.string().nullable().optional()
+}).refine((v) => v.name !== void 0 || v.color_tag !== void 0, { message: "At least one of name or color_tag must be provided" });
+const folderUpdateResponseSchema = z.object({ folder: folderSchema });
+const folderDeleteResponseSchema = z.object({
+	success: z.literal(true),
+	id: nonEmptyString,
+	permanent: z.boolean(),
+	folders_deleted: z.number().int().nonnegative().optional()
+});
+const folderRestoreResponseSchema = z.object({
+	success: z.literal(true),
+	id: nonEmptyString
+});
+//#endregion
+//#region src/services.ts
+/** Public service info returned to admins. Never exposes secrets. */
+const serviceSchema = z.object({
+	id: nonEmptyString,
+	name: nonEmptyString,
+	max_storage_bytes: positiveInt,
+	current_used_bytes: z.number().int().nonnegative(),
+	max_file_size_bytes: positiveInt,
+	created_at: unixTimestamp
+});
+const serviceDetailResponseSchema = z.object({ service: serviceSchema });
+const serviceUsageResponseSchema = z.object({
+	service_id: nonEmptyString,
+	max_storage_bytes: positiveInt,
+	current_used_bytes: z.number().int().nonnegative(),
+	used_percent: z.number().min(0).max(100)
+});
+const auditEventActionSchema = z.enum([
+	"upload_completed",
+	"file_deleted",
+	"folder_deleted",
+	"quota_exceeded"
+]);
+const auditEventSchema = z.object({
+	id: nonEmptyString,
+	service_id: nonEmptyString,
+	user_id: nonEmptyString,
+	action: auditEventActionSchema,
+	resource_type: z.enum([
+		"file",
+		"folder",
+		"service"
+	]),
+	resource_id: nonEmptyString,
+	metadata: z.record(z.string(), z.unknown()).nullable(),
+	ip_address: z.string().nullable(),
+	created_at: unixTimestamp
+});
+const auditLogListQuerySchema = z.object({
+	user_id: nonEmptyString.optional(),
+	action: auditEventActionSchema.optional(),
+	resource_type: z.enum([
+		"file",
+		"folder",
+		"service"
+	]).optional(),
+	cursor: nonEmptyString.optional(),
+	limit: z.number().int().min(1).max(200).optional()
+});
+const auditLogListResponseSchema = z.object({
+	items: z.array(auditEventSchema),
+	next_cursor: z.string().nullable(),
+	limit: positiveInt
+});
+//#endregion
+//#region src/client.ts
+var UnisourceError = class extends Error {
+	constructor(message, status, body) {
+		super(message);
+		this.status = status;
+		this.body = body;
+		this.name = "UnisourceError";
+	}
+};
+var UnisourceNetworkError = class extends Error {
+	constructor(message, cause) {
+		super(message);
+		this.cause = cause;
+		this.name = "UnisourceNetworkError";
+	}
+};
+async function apiRequest(config, method, path, options = {}) {
+	const token = await config.getToken();
+	const url = new URL(path, config.baseUrl);
+	if (options.query) {
+		for (const [key, value] of Object.entries(options.query)) if (value !== void 0 && value !== null) url.searchParams.set(key, String(value));
+	}
+	const headers = { "X-Service-ID": config.serviceId };
+	if (token) headers["Authorization"] = `Bearer ${token}`;
+	if (options.body !== void 0) headers["Content-Type"] = "application/json";
+	let response;
+	try {
+		response = await fetch(url.toString(), {
+			method,
+			headers,
+			body: options.body !== void 0 ? JSON.stringify(options.body) : void 0
+		});
+	} catch (err) {
+		throw new UnisourceNetworkError("Network request failed", err);
+	}
+	if (!response.ok) {
+		let body;
+		try {
+			body = await response.json();
+		} catch {
+			body = {
+				error: "Unknown",
+				message: response.statusText
+			};
+		}
+		throw new UnisourceError(body.message, response.status, body);
+	}
+	return response.json();
+}
+var UnisourceClient = class {
+	config;
+	constructor(config) {
+		this.config = config;
+	}
+	upload = {
+		r2Init: (body) => apiRequest(this.config, "POST", "/upload/r2/init", { body }),
+		appwriteInit: (body) => apiRequest(this.config, "POST", "/upload/appwrite/init", { body }),
+		complete: (body) => apiRequest(this.config, "POST", "/upload/complete", { body }),
+		fail: (body) => apiRequest(this.config, "POST", "/upload/fail", { body })
+	};
+	myFiles = {
+		list: (query) => apiRequest(this.config, "GET", "/my-files", { query }),
+		get: (id) => apiRequest(this.config, "GET", `/my-files/${id}`),
+		downloadUrl: (id) => apiRequest(this.config, "GET", `/my-files/${id}/download-url`),
+		move: (id, body) => apiRequest(this.config, "PATCH", `/my-files/${id}/move`, { body }),
+		delete: (id, query) => apiRequest(this.config, "DELETE", `/my-files/${id}`, { query }),
+		restore: (id) => apiRequest(this.config, "POST", `/my-files/${id}/restore`)
+	};
+	folders = {
+		list: (query) => apiRequest(this.config, "GET", "/folders", { query }),
+		create: (body) => apiRequest(this.config, "POST", "/folders", { body }),
+		update: (id, body) => apiRequest(this.config, "PATCH", `/folders/${id}`, { body }),
+		delete: (id, query) => apiRequest(this.config, "DELETE", `/folders/${id}`, { query }),
+		restore: (id) => apiRequest(this.config, "POST", `/folders/${id}/restore`)
+	};
+	admin = {
+		serviceDetail: () => apiRequest(this.config, "GET", "/admin/service"),
+		usage: () => apiRequest(this.config, "GET", "/admin/service/usage"),
+		listUploads: (query) => apiRequest(this.config, "GET", "/files", { query }),
+		auditLog: (query) => apiRequest(this.config, "GET", "/admin/audit-log", { query })
+	};
+};
 //#endregion
-export { FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, apiErrorSchema, fileDeleteResponseSchema, fileDetailsResponseSchema, fileDownloadUrlResponseSchema, fileRecordSchema, filesListQuerySchema, filesListResponseSchema, uploadAppwriteInitRequestSchema, uploadAppwriteInitResponseSchema, uploadCompleteResponseSchema, uploadDestinationSchema, uploadFailResponseSchema, uploadLifecycleRequestSchema, uploadR2InitRequestSchema, uploadR2InitResponseSchema, uploadStatusSchema };
+export { FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT, UnisourceClient, UnisourceError, UnisourceNetworkError, apiErrorSchema, auditEventActionSchema, auditEventSchema, auditLogListQuerySchema, auditLogListResponseSchema, fileDeleteResponseSchema, fileDownloadUrlResponseSchema, fileMoveRequestSchema, fileRecordDetailResponseSchema, fileRecordSchema, fileRecordsListQuerySchema, fileRecordsListResponseSchema, fileRestoreResponseSchema, folderCreateRequestSchema, folderCreateResponseSchema, folderDeleteResponseSchema, folderListQuerySchema, folderListResponseSchema, folderRestoreResponseSchema, folderSchema, folderUpdateRequestSchema, folderUpdateResponseSchema, nonEmptyString, positiveInt, serviceDetailResponseSchema, serviceSchema, serviceUsageResponseSchema, unixTimestamp, uploadAppwriteInitRequestSchema, uploadAppwriteInitResponseSchema, uploadCompleteResponseSchema, uploadDestinationSchema, uploadFailResponseSchema, uploadLifecycleRequestSchema, uploadR2InitRequestSchema, uploadR2InitResponseSchema, uploadRecordSchema, uploadStatusSchema, uploadsListResponseSchema };

package/package.json

@@ -2,7 +2,7 @@
   "name": "@unisource/sdk",
   "private": false,
   "type": "module",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Wspolne kontrakty danych dla backendu i frontendu UniSource.",
   "license": "MIT",
   "publishConfig": {
@@ -30,7 +30,7 @@
   "scripts": {
     "build": "tsdown && node -e \"const fs=require('node:fs'); if (fs.existsSync('dist/index.d.mts')) fs.copyFileSync('dist/index.d.mts','dist/index.d.ts');\"",
     "dev": "tsdown --watch",
-    "test": "vitest",
+    "test": "pnpm run build && vitest",
     "typecheck": "tsc --noEmit"
   }
 }

package/src/client.ts

@@ -0,0 +1,233 @@
+import type { ApiError } from './primitives';
+
+// ─── SDK Error classes ────────────────────────────────────────────────────────
+
+export class UnisourceError extends Error {
+  constructor(
+    message: string,
+    public readonly status: number,
+    public readonly body: ApiError
+  ) {
+    super(message);
+    this.name = 'UnisourceError';
+  }
+}
+
+export class UnisourceNetworkError extends Error {
+  constructor(
+    message: string,
+    public readonly cause: unknown
+  ) {
+    super(message);
+    this.name = 'UnisourceNetworkError';
+  }
+}
+
+// ─── Config ───────────────────────────────────────────────────────────────────
+
+export interface UnisourceClientConfig {
+  /** Base URL of the UniSource API, e.g. https://api.usrc.dev */
+  baseUrl: string;
+  /** Service identifier — tells the backend which service this client belongs to */
+  serviceId: string;
+  /**
+   * Returns a fresh JWT or API key for each request.
+   * Return null/undefined to send unauthenticated requests.
+   */
+  getToken: () => string | null | undefined | Promise<string | null | undefined>;
+}
+
+// ─── Internal fetch helper ────────────────────────────────────────────────────
+
+async function apiRequest<T>(
+  config: UnisourceClientConfig,
+  method: string,
+  path: string,
+  options: { body?: unknown; query?: Record<string, string | number | boolean | undefined | null> } = {}
+): Promise<T> {
+  const token = await config.getToken();
+
+  const url = new URL(path, config.baseUrl);
+  if (options.query) {
+    for (const [key, value] of Object.entries(options.query)) {
+      if (value !== undefined && value !== null) {
+        url.searchParams.set(key, String(value));
+      }
+    }
+  }
+
+  const headers: Record<string, string> = {
+    'X-Service-ID': config.serviceId,
+  };
+  if (token) {
+    headers['Authorization'] = `Bearer ${token}`;
+  }
+  if (options.body !== undefined) {
+    headers['Content-Type'] = 'application/json';
+  }
+
+  let response: Response;
+  try {
+    response = await fetch(url.toString(), {
+      method,
+      headers,
+      body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
+    });
+  } catch (err) {
+    throw new UnisourceNetworkError('Network request failed', err);
+  }
+
+  if (!response.ok) {
+    let body: ApiError;
+    try {
+      body = (await response.json()) as ApiError;
+    } catch {
+      body = { error: 'Unknown', message: response.statusText };
+    }
+    throw new UnisourceError(body.message, response.status, body);
+  }
+
+  return response.json() as Promise<T>;
+}
+
+// ─── Client class ─────────────────────────────────────────────────────────────
+
+import type {
+  UploadR2InitRequest,
+  UploadR2InitResponse,
+  UploadAppwriteInitRequest,
+  UploadAppwriteInitResponse,
+  UploadLifecycleRequest,
+  UploadCompleteResponse,
+  UploadFailResponse,
+  UploadsListResponse,
+} from './uploads';
+
+import type {
+  FileRecord,
+  FileRecordsListQuery,
+  FileRecordsListResponse,
+  FileRecordDetailResponse,
+  FileMoveRequest,
+  FileDownloadUrlResponse,
+  FileDeleteResponse,
+  FileRestoreResponse,
+} from './fileRecords';
+
+import type {
+  FolderListQuery,
+  FolderListResponse,
+  FolderCreateRequest,
+  FolderCreateResponse,
+  FolderUpdateRequest,
+  FolderUpdateResponse,
+  FolderDeleteResponse,
+  FolderRestoreResponse,
+} from './folders';
+
+import type {
+  ServiceDetailResponse,
+  ServiceUsageResponse,
+  AuditLogListQuery,
+  AuditLogListResponse,
+} from './services';
+
+export class UnisourceClient {
+  private config: UnisourceClientConfig;
+
+  constructor(config: UnisourceClientConfig) {
+    this.config = config;
+  }
+
+  // ─── Upload ────────────────────────────────────────────────────────────────
+
+  readonly upload = {
+    /** Initiate an R2 upload — returns a presigned PUT URL */
+    r2Init: (body: UploadR2InitRequest): Promise<UploadR2InitResponse> =>
+      apiRequest(this.config, 'POST', '/upload/r2/init', { body }),
+
+    /** Initiate an Appwrite upload — returns credentials for direct SDK upload */
+    appwriteInit: (body: UploadAppwriteInitRequest): Promise<UploadAppwriteInitResponse> =>
+      apiRequest(this.config, 'POST', '/upload/appwrite/init', { body }),
+
+    /** Confirm that the file was successfully uploaded to storage */
+    complete: (body: UploadLifecycleRequest): Promise<UploadCompleteResponse> =>
+      apiRequest(this.config, 'POST', '/upload/complete', { body }),
+
+    /** Mark an upload as failed and release reserved quota */
+    fail: (body: UploadLifecycleRequest): Promise<UploadFailResponse> =>
+      apiRequest(this.config, 'POST', '/upload/fail', { body }),
+  };
+
+  // ─── My Files ─────────────────────────────────────────────────────────────
+
+  readonly myFiles = {
+    /** List files owned by the authenticated user */
+    list: (query?: FileRecordsListQuery): Promise<FileRecordsListResponse> =>
+      apiRequest(this.config, 'GET', '/my-files', { query }),
+
+    /** Get a single file record */
+    get: (id: string): Promise<FileRecordDetailResponse> =>
+      apiRequest(this.config, 'GET', `/my-files/${id}`),
+
+    /** Get a time-limited download URL (never cached by proxy) */
+    downloadUrl: (id: string): Promise<FileDownloadUrlResponse> =>
+      apiRequest(this.config, 'GET', `/my-files/${id}/download-url`),
+
+    /** Move file to a different folder (null = root) */
+    move: (id: string, body: FileMoveRequest): Promise<{ file: FileRecord }> =>
+      apiRequest(this.config, 'PATCH', `/my-files/${id}/move`, { body }),
+
+    /** Soft-delete (move to trash) or permanently delete */
+    delete: (id: string, query?: { permanent?: boolean }): Promise<FileDeleteResponse> =>
+      apiRequest(this.config, 'DELETE', `/my-files/${id}`, { query }),
+
+    /** Restore a file from trash */
+    restore: (id: string): Promise<FileRestoreResponse> =>
+      apiRequest(this.config, 'POST', `/my-files/${id}/restore`),
+  };
+
+  // ─── Folders ──────────────────────────────────────────────────────────────
+
+  readonly folders = {
+    /** List folders owned by the authenticated user */
+    list: (query?: FolderListQuery): Promise<FolderListResponse> =>
+      apiRequest(this.config, 'GET', '/folders', { query }),
+
+    /** Create a new folder */
+    create: (body: FolderCreateRequest): Promise<FolderCreateResponse> =>
+      apiRequest(this.config, 'POST', '/folders', { body }),
+
+    /** Update folder name or color tag */
+    update: (id: string, body: FolderUpdateRequest): Promise<FolderUpdateResponse> =>
+      apiRequest(this.config, 'PATCH', `/folders/${id}`, { body }),
+
+    /** Soft-delete or permanently delete a folder and its contents */
+    delete: (id: string, query?: { permanent?: boolean }): Promise<FolderDeleteResponse> =>
+      apiRequest(this.config, 'DELETE', `/folders/${id}`, { query }),
+
+    /** Restore a folder from trash */
+    restore: (id: string): Promise<FolderRestoreResponse> =>
+      apiRequest(this.config, 'POST', `/folders/${id}/restore`),
+  };
+
+  // ─── Admin ────────────────────────────────────────────────────────────────
+
+  readonly admin = {
+    /** Get service info and quota limits */
+    serviceDetail: (): Promise<ServiceDetailResponse> =>
+      apiRequest(this.config, 'GET', '/admin/service'),
+
+    /** Get real-time storage usage for the service */
+    usage: (): Promise<ServiceUsageResponse> =>
+      apiRequest(this.config, 'GET', '/admin/service/usage'),
+
+    /** List all uploads (pending/completed/failed) for this service */
+    listUploads: (query?: { status?: string; cursor?: string; limit?: number }): Promise<UploadsListResponse> =>
+      apiRequest(this.config, 'GET', '/files', { query }),
+
+    /** List audit log events for this service */
+    auditLog: (query?: AuditLogListQuery): Promise<AuditLogListResponse> =>
+      apiRequest(this.config, 'GET', '/admin/audit-log', { query }),
+  };
+}