@unisource/sdk 0.2.0 → 0.3.0

package/src/fileRecords.ts

@@ -1,87 +1,99 @@
-import { z } from 'zod';
-import { nonEmptyString, positiveInt, uploadDestinationSchema } from './primitives';
-
-// ─── User-facing file record ──────────────────────────────────────────────────
-
-/**
- * A confirmed file record owned by a user.
- * Internal fields (storage_key, bucket) are intentionally excluded from the public API.
- */
-export 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,
-});
-export type FileRecord = z.infer<typeof fileRecordSchema>;
-
-// ─── List ─────────────────────────────────────────────────────────────────────
-
-export const FILES_DEFAULT_LIMIT = 25;
-export const FILES_MAX_LIMIT = 100;
-
-export const fileRecordsListQuerySchema = z.object({
-  folder_id: nonEmptyString.nullable().optional(),
-  is_trashed: z.boolean().optional(),
-  cursor: nonEmptyString.optional(),
-  limit: z.number().int().min(1).max(FILES_MAX_LIMIT).optional(),
-});
-export type FileRecordsListQuery = z.infer<typeof fileRecordsListQuerySchema>;
-
-export const fileRecordsListResponseSchema = z.object({
-  items: z.array(fileRecordSchema),
-  next_cursor: z.string().nullable(),
-  limit: positiveInt,
-});
-export type FileRecordsListResponse = z.infer<typeof fileRecordsListResponseSchema>;
-
-// ─── Single file detail ───────────────────────────────────────────────────────
-
-export const fileRecordDetailResponseSchema = z.object({
-  file: fileRecordSchema,
-});
-export type FileRecordDetailResponse = z.infer<typeof fileRecordDetailResponseSchema>;
-
-// ─── Move ────────────────────────────────────────────────────────────────────
-
-export const fileMoveRequestSchema = z.object({
-  /** null = move to root, undefined = keep unchanged */
-  folder_id: nonEmptyString.nullable().optional(),
-});
-export type FileMoveRequest = z.infer<typeof fileMoveRequestSchema>;
-
-// ─── Download URL ─────────────────────────────────────────────────────────────
-
-export const fileDownloadUrlResponseSchema = z.object({
-  upload_id: nonEmptyString,
-  destination: uploadDestinationSchema,
-  download_url: z.string().url(),
-  expires_at: positiveInt,
-});
-export type FileDownloadUrlResponse = z.infer<typeof fileDownloadUrlResponseSchema>;
-
-// ─── Delete ───────────────────────────────────────────────────────────────────
-
-export const fileDeleteResponseSchema = z.object({
-  success: z.literal(true),
-  id: nonEmptyString,
-  permanent: z.boolean(),
-});
-export type FileDeleteResponse = z.infer<typeof fileDeleteResponseSchema>;
-
-// ─── Restore ──────────────────────────────────────────────────────────────────
-
-export const fileRestoreResponseSchema = z.object({
-  success: z.literal(true),
-  id: nonEmptyString,
-});
-export type FileRestoreResponse = z.infer<typeof fileRestoreResponseSchema>;
+import { z } from 'zod';
+import { nonEmptyString, positiveInt, uploadDestinationSchema, FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT } from './primitives';
+
+// ─── User-facing file record ──────────────────────────────────────────────────
+
+/**
+ * A confirmed file record owned by a user.
+ * Internal fields (storage_key, bucket) are intentionally excluded from the public API.
+ */
+export 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,
+});
+export type FileRecord = z.infer<typeof fileRecordSchema>;
+
+// ─── List ─────────────────────────────────────────────────────────────────────
+
+export { FILES_DEFAULT_LIMIT, FILES_MAX_LIMIT };
+
+
+export const fileRecordsListQuerySchema = z.object({
+  folder_id: nonEmptyString.nullable().optional(),
+  is_trashed: z.boolean().optional(),
+  cursor: nonEmptyString.optional(),
+  limit: z.number().int().min(1).max(FILES_MAX_LIMIT).optional(),
+});
+export type FileRecordsListQuery = z.infer<typeof fileRecordsListQuerySchema>;
+
+export const fileRecordsListResponseSchema = z.object({
+  items: z.array(fileRecordSchema),
+  next_cursor: z.string().nullable(),
+  limit: positiveInt,
+});
+export type FileRecordsListResponse = z.infer<typeof fileRecordsListResponseSchema>;
+
+// ─── Single file detail ───────────────────────────────────────────────────────
+
+export const fileRecordDetailResponseSchema = z.object({
+  file: fileRecordSchema,
+});
+export type FileRecordDetailResponse = z.infer<typeof fileRecordDetailResponseSchema>;
+
+// ─── Move ────────────────────────────────────────────────────────────────────
+
+export const fileMoveRequestSchema = z.object({
+  /** null = move to root, undefined = keep unchanged */
+  folder_id: nonEmptyString.nullable().optional(),
+});
+export type FileMoveRequest = z.infer<typeof fileMoveRequestSchema>;
+
+// ─── Download URL ─────────────────────────────────────────────────────────────
+
+export const fileDownloadUrlResponseSchema = z.object({
+  upload_id: nonEmptyString,
+  destination: uploadDestinationSchema,
+  download_url: z.string().url(),
+  expires_at: positiveInt,
+});
+export type FileDownloadUrlResponse = z.infer<typeof fileDownloadUrlResponseSchema>;
+
+// ─── Delete ───────────────────────────────────────────────────────────────────
+
+export const fileDeleteResponseSchema = z.object({
+  success: z.literal(true),
+  id: nonEmptyString,
+  permanent: z.boolean(),
+});
+export type FileDeleteResponse = z.infer<typeof fileDeleteResponseSchema>;
+
+// ─── Restore ──────────────────────────────────────────────────────────────────
+
+export const fileRestoreResponseSchema = z.object({
+  success: z.literal(true),
+  id: nonEmptyString,
+});
+export type FileRestoreResponse = z.infer<typeof fileRestoreResponseSchema>;
+
+// ─── Update (rename) ──────────────────────────────────────────────────────────
+
+export const fileUpdateRequestSchema = z.object({
+  filename: nonEmptyString,
+});
+export type FileUpdateRequest = z.infer<typeof fileUpdateRequestSchema>;
+
+export const fileUpdateResponseSchema = z.object({
+  file: fileRecordSchema,
+});
+export type FileUpdateResponse = z.infer<typeof fileUpdateResponseSchema>;

package/src/folders.ts

@@ -1,84 +1,97 @@
-import { z } from 'zod';
-import { nonEmptyString, positiveInt } from './primitives';
-
-// ─── Folder record ────────────────────────────────────────────────────────────
-
-export 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,
-});
-export type Folder = z.infer<typeof folderSchema>;
-
-// ─── List ─────────────────────────────────────────────────────────────────────
-
-export 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(),
-});
-export type FolderListQuery = z.infer<typeof folderListQuerySchema>;
-
-export const folderListResponseSchema = z.object({
-  items: z.array(folderSchema),
-  next_cursor: z.string().nullable(),
-  limit: positiveInt,
-});
-export type FolderListResponse = z.infer<typeof folderListResponseSchema>;
-
-// ─── Create ───────────────────────────────────────────────────────────────────
-
-export const folderCreateRequestSchema = z.object({
-  name: nonEmptyString,
-  parent_id: nonEmptyString.optional(),
-  color_tag: z.string().optional(),
-});
-export type FolderCreateRequest = z.infer<typeof folderCreateRequestSchema>;
-
-export const folderCreateResponseSchema = z.object({
-  folder: folderSchema,
-});
-export type FolderCreateResponse = z.infer<typeof folderCreateResponseSchema>;
-
-// ─── Update ───────────────────────────────────────────────────────────────────
-
-export const folderUpdateRequestSchema = z
-  .object({
-    name: nonEmptyString.optional(),
-    color_tag: z.string().nullable().optional(),
-  })
-  .refine((v) => v.name !== undefined || v.color_tag !== undefined, {
-    message: 'At least one of name or color_tag must be provided',
-  });
-export type FolderUpdateRequest = z.infer<typeof folderUpdateRequestSchema>;
-
-export const folderUpdateResponseSchema = z.object({
-  folder: folderSchema,
-});
-export type FolderUpdateResponse = z.infer<typeof folderUpdateResponseSchema>;
-
-// ─── Delete ───────────────────────────────────────────────────────────────────
-
-export const folderDeleteResponseSchema = z.object({
-  success: z.literal(true),
-  id: nonEmptyString,
-  permanent: z.boolean(),
-  folders_deleted: z.number().int().nonnegative().optional(),
-});
-export type FolderDeleteResponse = z.infer<typeof folderDeleteResponseSchema>;
-
-// ─── Restore ──────────────────────────────────────────────────────────────────
-
-export const folderRestoreResponseSchema = z.object({
-  success: z.literal(true),
-  id: nonEmptyString,
-});
-export type FolderRestoreResponse = z.infer<typeof folderRestoreResponseSchema>;
+import { z } from 'zod';
+import { nonEmptyString, positiveInt, FILES_MAX_LIMIT } from './primitives';
+
+// ─── Folder record ────────────────────────────────────────────────────────────
+
+export 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,
+});
+export type Folder = z.infer<typeof folderSchema>;
+
+// ─── List ─────────────────────────────────────────────────────────────────────
+
+export const folderListQuerySchema = z
+  .object({
+    parent_id: nonEmptyString.nullable().optional(),
+    trashed: z.boolean().optional(),
+    is_trashed: z.boolean().optional(),
+    cursor: nonEmptyString.optional(),
+    limit: z.number().int().min(1).max(FILES_MAX_LIMIT).optional(),
+  })
+  .refine(
+    (v) => !(v.trashed !== undefined && v.is_trashed !== undefined),
+    { message: 'Use either trashed or is_trashed, not both' }
+  );
+export type FolderListQuery = z.infer<typeof folderListQuerySchema>;
+
+export const folderListResponseSchema = z.object({
+  items: z.array(folderSchema),
+  next_cursor: z.string().nullable(),
+  limit: positiveInt,
+});
+export type FolderListResponse = z.infer<typeof folderListResponseSchema>;
+
+// ─── Create ───────────────────────────────────────────────────────────────────
+
+export const folderCreateRequestSchema = z.object({
+  name: nonEmptyString,
+  parent_id: nonEmptyString.optional(),
+  color_tag: z.string().optional(),
+});
+export type FolderCreateRequest = z.infer<typeof folderCreateRequestSchema>;
+
+export const folderCreateResponseSchema = z.object({
+  folder: folderSchema,
+});
+export type FolderCreateResponse = z.infer<typeof folderCreateResponseSchema>;
+
+// ─── Update ───────────────────────────────────────────────────────────────────
+
+export const folderUpdateRequestSchema = z
+  .object({
+    name: nonEmptyString.optional(),
+    color_tag: z.string().nullable().optional(),
+  })
+  .refine((v) => v.name !== undefined || v.color_tag !== undefined, {
+    message: 'At least one of name or color_tag must be provided',
+  });
+export type FolderUpdateRequest = z.infer<typeof folderUpdateRequestSchema>;
+
+export const folderUpdateResponseSchema = z.object({
+  folder: folderSchema,
+});
+export type FolderUpdateResponse = z.infer<typeof folderUpdateResponseSchema>;
+
+// ─── Delete ───────────────────────────────────────────────────────────────────
+
+export const folderDeleteResponseSchema = z.object({
+  success: z.literal(true),
+  id: nonEmptyString,
+  permanent: z.boolean(),
+  folders_deleted: z.number().int().nonnegative().optional(),
+});
+export type FolderDeleteResponse = z.infer<typeof folderDeleteResponseSchema>;
+
+// ─── Single folder detail ─────────────────────────────────────────────────────
+
+export const folderDetailResponseSchema = z.object({
+  folder: folderSchema,
+});
+export type FolderDetailResponse = z.infer<typeof folderDetailResponseSchema>;
+
+// ─── Restore ──────────────────────────────────────────────────────────────────
+
+export const folderRestoreResponseSchema = z.object({
+  success: z.literal(true),
+  id: nonEmptyString,
+});
+export type FolderRestoreResponse = z.infer<typeof folderRestoreResponseSchema>;