@unisource/sdk 0.2.0 → 0.3.0

package/src/services.ts

@@ -1,69 +1,135 @@
-import { z } from 'zod';
-import { nonEmptyString, positiveInt, unixTimestamp } from './primitives';
-
-// ─── Service record ───────────────────────────────────────────────────────────
-
-/** Public service info returned to admins. Never exposes secrets. */
-export 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,
-});
-export type Service = z.infer<typeof serviceSchema>;
-
-export const serviceDetailResponseSchema = z.object({
-  service: serviceSchema,
-});
-export type ServiceDetailResponse = z.infer<typeof serviceDetailResponseSchema>;
-
-// ─── Service usage summary ────────────────────────────────────────────────────
-
-export 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),
-});
-export type ServiceUsageResponse = z.infer<typeof serviceUsageResponseSchema>;
-
-// ─── Audit log event ──────────────────────────────────────────────────────────
-
-export const auditEventActionSchema = z.enum([
-  'upload_completed',
-  'file_deleted',
-  'folder_deleted',
-  'quota_exceeded',
-]);
-export type AuditEventAction = z.infer<typeof auditEventActionSchema>;
-
-export 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,
-});
-export type AuditEvent = z.infer<typeof auditEventSchema>;
-
-export 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(),
-});
-export type AuditLogListQuery = z.infer<typeof auditLogListQuerySchema>;
-
-export const auditLogListResponseSchema = z.object({
-  items: z.array(auditEventSchema),
-  next_cursor: z.string().nullable(),
-  limit: positiveInt,
-});
-export type AuditLogListResponse = z.infer<typeof auditLogListResponseSchema>;
+import { z } from 'zod';
+import { nonEmptyString, positiveInt, unixTimestamp } from './primitives';
+
+// ─── Service record ───────────────────────────────────────────────────────────
+
+/** Public service info returned to admins. Never exposes secrets. */
+export 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,
+});
+export type Service = z.infer<typeof serviceSchema>;
+
+export const serviceDetailResponseSchema = z.object({
+  service: serviceSchema,
+});
+export type ServiceDetailResponse = z.infer<typeof serviceDetailResponseSchema>;
+
+export const adminServiceUpdateRequestSchema = z
+  .object({
+    max_storage_bytes: positiveInt.optional(),
+    max_file_size_bytes: positiveInt.optional(),
+  })
+  .refine(
+    (v) => v.max_storage_bytes !== undefined || v.max_file_size_bytes !== undefined,
+    { message: 'At least one of max_storage_bytes or max_file_size_bytes must be provided' }
+  );
+export type AdminServiceUpdateRequest = z.infer<typeof adminServiceUpdateRequestSchema>;
+
+export const adminServiceUpdateResponseSchema = serviceDetailResponseSchema;
+export type AdminServiceUpdateResponse = z.infer<typeof adminServiceUpdateResponseSchema>;
+
+// ─── Service usage summary ────────────────────────────────────────────────────
+
+export 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),
+});
+export type ServiceUsageResponse = z.infer<typeof serviceUsageResponseSchema>;
+
+// ─── Audit log event ──────────────────────────────────────────────────────────
+
+export const auditEventActionSchema = z.enum([
+  'upload_completed',
+  'file_deleted',
+  'folder_deleted',
+  'quota_exceeded',
+  'share_link_accessed',
+  'quota_reconciled',
+]);
+export type AuditEventAction = z.infer<typeof auditEventActionSchema>;
+
+export 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,
+});
+export type AuditEvent = z.infer<typeof auditEventSchema>;
+
+export 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(),
+});
+export type AuditLogListQuery = z.infer<typeof auditLogListQuerySchema>;
+
+export const auditLogListResponseSchema = z.object({
+  items: z.array(auditEventSchema),
+  next_cursor: z.string().nullable(),
+  limit: positiveInt,
+});
+export type AuditLogListResponse = z.infer<typeof auditLogListResponseSchema>;
+
+export const adminUserSchema = z.object({
+  id: nonEmptyString,
+  name: z.string(),
+  email: z.string().email(),
+  status: z.boolean(),
+  labels: z.array(z.string()),
+  role: nonEmptyString,
+  has_service_access: z.boolean(),
+  max_storage_bytes: positiveInt.nullable(),
+  effective_max_storage_bytes: positiveInt,
+  current_used_bytes: z.number().int().nonnegative(),
+  registration: unixTimestamp,
+  email_verification: z.boolean(),
+});
+export type AdminUser = z.infer<typeof adminUserSchema>;
+
+export const adminUserListResponseSchema = z.object({
+  items: z.array(adminUserSchema),
+  total: z.number().int().nonnegative(),
+  offset: z.number().int().nonnegative(),
+  limit: positiveInt,
+});
+export type AdminUserListResponse = z.infer<typeof adminUserListResponseSchema>;
+
+export const adminUserUpdateRequestSchema = z.object({
+  name: z.string().trim().min(1).max(128).optional(),
+  email: z.string().trim().email().optional(),
+  status: z.boolean().optional(),
+  labels: z.array(z.string().trim().min(1)).max(32).optional(),
+  role: z.enum(['user', 'plus', 'admin']).optional(),
+  max_storage_bytes: positiveInt.nullable().optional(),
+});
+export type AdminUserUpdateRequest = z.infer<typeof adminUserUpdateRequestSchema>;
+
+export const adminUserUpdateResponseSchema = z.object({
+  user: adminUserSchema,
+});
+export type AdminUserUpdateResponse = z.infer<typeof adminUserUpdateResponseSchema>;
+
+export const adminUserPasswordResetRequestSchema = z.object({
+  password: z.string().min(8).max(256),
+});
+export type AdminUserPasswordResetRequest = z.infer<typeof adminUserPasswordResetRequestSchema>;
+
+export const adminUserPasswordResetResponseSchema = z.object({
+  success: z.literal(true),
+  user_id: nonEmptyString,
+});
+export type AdminUserPasswordResetResponse = z.infer<typeof adminUserPasswordResetResponseSchema>;

package/src/shareLinks.ts

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import { nonEmptyString, positiveInt, unixTimestamp } from './primitives';
+
+export const shareLinkSchema = z.object({
+  id: nonEmptyString,
+  service_id: nonEmptyString,
+  file_id: nonEmptyString,
+  user_id: nonEmptyString,
+  slug: nonEmptyString,
+  name: z.string().nullable(),
+  has_password: z.boolean(),
+  expires_at: unixTimestamp.nullable(),
+  download_count: z.number().int().nonnegative(),
+  max_downloads: positiveInt.nullable(),
+  is_active: z.boolean(),
+  created_at: unixTimestamp,
+  updated_at: unixTimestamp,
+});
+export type ShareLink = z.infer<typeof shareLinkSchema>;
+
+export const shareLinkCreateRequestSchema = z.object({
+  slug: z.string().trim().min(3).max(64).optional(),
+  name: z.string().trim().max(128).optional(),
+  password: z.string().min(1).optional(),
+  expires_at: unixTimestamp.optional(),
+  max_downloads: positiveInt.optional(),
+});
+export type ShareLinkCreateRequest = z.infer<typeof shareLinkCreateRequestSchema>;
+
+export const shareLinkUpdateRequestSchema = z
+  .object({
+    name: z.string().trim().max(128).nullable().optional(),
+    is_active: z.boolean().optional(),
+    password: z.string().min(1).nullable().optional(),
+    expires_at: unixTimestamp.nullable().optional(),
+    max_downloads: positiveInt.nullable().optional(),
+  })
+  .refine(
+    (v) =>
+      v.name !== undefined ||
+      v.is_active !== undefined ||
+      v.password !== undefined ||
+      v.expires_at !== undefined ||
+      v.max_downloads !== undefined,
+    { message: 'At least one field must be provided' }
+  );
+export type ShareLinkUpdateRequest = z.infer<typeof shareLinkUpdateRequestSchema>;
+
+export const shareLinkListResponseSchema = z.object({
+  items: z.array(shareLinkSchema),
+});
+export type ShareLinkListResponse = z.infer<typeof shareLinkListResponseSchema>;
+
+export const shareLinkCreateResponseSchema = z.object({
+  link: shareLinkSchema,
+});
+export type ShareLinkCreateResponse = z.infer<typeof shareLinkCreateResponseSchema>;
+
+export const shareLinkUpdateResponseSchema = z.object({
+  link: shareLinkSchema,
+});
+export type ShareLinkUpdateResponse = z.infer<typeof shareLinkUpdateResponseSchema>;
+
+// Returned when link has no password OR after unlock
+export const publicFileAccessResponseSchema = z.object({
+  file_id: nonEmptyString,
+  filename: nonEmptyString,
+  size: positiveInt,
+  mime_type: nonEmptyString,
+  requires_password: z.literal(false),
+  download_url: z.string().url(),
+  url_expires_at: unixTimestamp,
+  link_name: z.string().nullable(),
+  link_expires_at: unixTimestamp.nullable(),
+});
+export type PublicFileAccessResponse = z.infer<typeof publicFileAccessResponseSchema>;
+
+// Returned when link requires password (no download URL)
+export const publicFileLockedResponseSchema = z.object({
+  filename: nonEmptyString,
+  size: positiveInt,
+  mime_type: nonEmptyString,
+  requires_password: z.literal(true),
+  link_name: z.string().nullable(),
+});
+export type PublicFileLockedResponse = z.infer<typeof publicFileLockedResponseSchema>;
+
+// ─── Delete ───────────────────────────────────────────────────────────────────
+export const shareLinkDeleteResponseSchema = z.object({
+  success: z.literal(true),
+  id: nonEmptyString,
+});
+export type ShareLinkDeleteResponse = z.infer<typeof shareLinkDeleteResponseSchema>;

package/src/uploads.ts

@@ -1,90 +1,99 @@
-import { z } from 'zod';
-import { nonEmptyString, positiveInt, uploadDestinationSchema } from './primitives';
-
-// ─── Init: R2 ────────────────────────────────────────────────────────────────
-
-export const uploadR2InitRequestSchema = z.object({
-  filename: nonEmptyString,
-  size: positiveInt,
-  mime_type: nonEmptyString,
-});
-export type UploadR2InitRequest = z.infer<typeof uploadR2InitRequestSchema>;
-
-export const uploadR2InitResponseSchema = z.object({
-  upload_id: nonEmptyString,
-  destination: z.literal('r2'),
-  presigned_url: z.string().url(),
-  storage_key: nonEmptyString,
-  bucket: nonEmptyString,
-  expires_at: positiveInt,
-});
-export type UploadR2InitResponse = z.infer<typeof uploadR2InitResponseSchema>;
-
-// ─── Init: Appwrite ───────────────────────────────────────────────────────────
-
-export const uploadAppwriteInitRequestSchema = z.object({
-  filename: nonEmptyString,
-  size: positiveInt,
-  mime_type: nonEmptyString,
-});
-export type UploadAppwriteInitRequest = z.infer<typeof uploadAppwriteInitRequestSchema>;
-
-export const uploadAppwriteInitResponseSchema = z.object({
-  upload_id: nonEmptyString,
-  destination: z.literal('appwrite'),
-  appwrite_endpoint: z.string().url(),
-  appwrite_project_id: nonEmptyString,
-  appwrite_bucket_id: nonEmptyString,
-  file_id: nonEmptyString,
-  expires_at: positiveInt,
-});
-export type UploadAppwriteInitResponse = z.infer<typeof uploadAppwriteInitResponseSchema>;
-
-// ─── Lifecycle ────────────────────────────────────────────────────────────────
-
-export const uploadLifecycleRequestSchema = z.object({
-  upload_id: nonEmptyString,
-});
-export type UploadLifecycleRequest = z.infer<typeof uploadLifecycleRequestSchema>;
-
-export const uploadCompleteResponseSchema = z.object({
-  success: z.literal(true),
-  upload_id: nonEmptyString,
-  status: z.literal('completed'),
-});
-export type UploadCompleteResponse = z.infer<typeof uploadCompleteResponseSchema>;
-
-export const uploadFailResponseSchema = z.object({
-  success: z.literal(true),
-  upload_id: nonEmptyString,
-  status: z.literal('failed'),
-});
-export type UploadFailResponse = z.infer<typeof uploadFailResponseSchema>;
-
-// ─── Admin: list uploads ──────────────────────────────────────────────────────
-
-export const FILES_DEFAULT_LIMIT = 25;
-export const FILES_MAX_LIMIT = 100;
-
-/** Raw upload record — returned by admin `/files` endpoints. */
-export const uploadRecordSchema = z.object({
-  id: nonEmptyString,
-  service_id: nonEmptyString,
-  user_id: nonEmptyString.nullable(),
-  filename: nonEmptyString,
-  size: positiveInt,
-  mime_type: nonEmptyString,
-  destination: uploadDestinationSchema,
-  status: z.enum(['pending', 'completed', 'failed']),
-  expires_at: positiveInt,
-  created_at: positiveInt,
-  updated_at: positiveInt,
-});
-export type UploadRecord = z.infer<typeof uploadRecordSchema>;
-
-export const uploadsListResponseSchema = z.object({
-  items: z.array(uploadRecordSchema),
-  next_cursor: z.string().nullable(),
-  limit: positiveInt,
-});
-export type UploadsListResponse = z.infer<typeof uploadsListResponseSchema>;
+import { z } from 'zod';
+import { nonEmptyString, positiveInt, uploadDestinationSchema, uploadStatusSchema, FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT } from './primitives';
+
+// ─── Init: R2 ────────────────────────────────────────────────────────────────
+
+export const uploadR2InitRequestSchema = z.object({
+  filename: nonEmptyString,
+  size: positiveInt,
+  mime_type: nonEmptyString,
+  folder_id: nonEmptyString.optional(),
+  is_main_storage: z.boolean().optional().default(false),
+});
+export type UploadR2InitRequest = z.infer<typeof uploadR2InitRequestSchema>;
+
+export const uploadR2InitResponseSchema = z.object({
+  upload_id: nonEmptyString,
+  destination: z.literal('r2'),
+  presigned_url: z.string().url(),
+  storage_key: nonEmptyString,
+  bucket: nonEmptyString,
+  expires_at: positiveInt,
+});
+export type UploadR2InitResponse = z.infer<typeof uploadR2InitResponseSchema>;
+
+// ─── Init: Appwrite ───────────────────────────────────────────────────────────
+
+export const uploadAppwriteInitRequestSchema = z.object({
+  filename: nonEmptyString,
+  size: positiveInt,
+  mime_type: nonEmptyString,
+  folder_id: nonEmptyString.optional(),
+  is_main_storage: z.boolean().optional().default(false),
+});
+export type UploadAppwriteInitRequest = z.infer<typeof uploadAppwriteInitRequestSchema>;
+
+export const uploadAppwriteInitResponseSchema = z.object({
+  upload_id: nonEmptyString,
+  destination: z.literal('appwrite'),
+  appwrite_endpoint: z.string().url(),
+  appwrite_project_id: nonEmptyString,
+  appwrite_bucket_id: nonEmptyString,
+  file_id: nonEmptyString,
+  expires_at: positiveInt,
+});
+export type UploadAppwriteInitResponse = z.infer<typeof uploadAppwriteInitResponseSchema>;
+
+// ─── Lifecycle ────────────────────────────────────────────────────────────────
+
+export const uploadLifecycleRequestSchema = z.object({
+  upload_id: nonEmptyString,
+  is_main_storage: z.boolean().optional().default(false),
+});
+export type UploadLifecycleRequest = z.infer<typeof uploadLifecycleRequestSchema>;
+
+export const uploadCompleteResponseSchema = z.object({
+  success: z.literal(true),
+  upload_id: nonEmptyString,
+  status: z.literal('completed'),
+});
+export type UploadCompleteResponse = z.infer<typeof uploadCompleteResponseSchema>;
+
+export const uploadFailResponseSchema = z.object({
+  success: z.literal(true),
+  upload_id: nonEmptyString,
+  status: z.literal('failed'),
+});
+export type UploadFailResponse = z.infer<typeof uploadFailResponseSchema>;
+
+// ─── Admin: list uploads ──────────────────────────────────────────────────────
+
+export { FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT };
+
+/** Raw upload record — returned by admin `/files` endpoints. */
+export const uploadRecordSchema = z.object({
+  id: nonEmptyString,
+  service_id: nonEmptyString,
+  user_id: nonEmptyString.nullable(),
+  filename: nonEmptyString,
+  size: positiveInt,
+  mime_type: nonEmptyString,
+  destination: uploadDestinationSchema,
+  status: uploadStatusSchema,
+  expires_at: positiveInt,
+  created_at: positiveInt,
+  updated_at: positiveInt,
+});
+export type UploadRecord = z.infer<typeof uploadRecordSchema>;
+
+export const uploadsListResponseSchema = z.object({
+  items: z.array(uploadRecordSchema),
+  next_cursor: z.string().nullable(),
+  limit: positiveInt,
+});
+export type UploadsListResponse = z.infer<typeof uploadsListResponseSchema>;
+
+export const uploadRecordDetailResponseSchema = z.object({
+  upload: uploadRecordSchema,
+});
+export type UploadRecordDetailResponse = z.infer<typeof uploadRecordDetailResponseSchema>;