@unisource/sdk 1.0.0 → 1.1.0-beta.0

package/src/releases.ts

@@ -1,236 +0,0 @@
-import { z } from 'zod';
-import { nonEmptyString, positiveInt, uploadStatusSchema } from './primitives';
-
-const releaseIdSchema = z.string().trim().min(1).max(128);
-const releaseNameSchema = z.string().trim().min(1).max(256);
-const releaseFilenameSchema = z.string().trim().min(1).max(255);
-const releaseTagsSchema = z.array(z.string().trim().min(1).max(64)).max(32);
-const releaseNotesSchema = z.string().trim().max(10_000).nullable().optional();
-const releaseR2KeySchema = z.string().trim().min(1).max(1024);
-
-// ─── Release DTO ─────────────────────────────────────────────────────────────
-
-export const releaseDTOSchema = z.object({
-  id: nonEmptyString,
-  service_id: nonEmptyString,
-  name: nonEmptyString,
-  size: z.number().int().nonnegative(),
-  r2_key: nonEmptyString,
-  tags: z.array(nonEmptyString),
-  notes: z.string().nullable(),
-  force_update: z.boolean(),
-  uploaded_by: nonEmptyString,
-  upload_status: uploadStatusSchema,
-  created_at: nonEmptyString,
-});
-export type ReleaseDTO = z.infer<typeof releaseDTOSchema>;
-
-// ─── Upload Lifecycle ───────────────────────────────────────────────────────
-
-export const releaseUploadInitRequestSchema = z.object({
-  name: releaseNameSchema,
-  filename: releaseFilenameSchema,
-  tags: releaseTagsSchema.optional().default([]),
-  notes: releaseNotesSchema,
-  force_update: z.boolean().optional().default(false),
-});
-export type ReleaseUploadInitRequest = z.input<typeof releaseUploadInitRequestSchema>;
-
-export const releaseUploadInitResponseSchema = z.object({
-  release_id: nonEmptyString,
-  presigned_url: z.string().url(),
-  r2_key: nonEmptyString,
-  expires_at: positiveInt,
-});
-export type ReleaseUploadInitResponse = z.infer<typeof releaseUploadInitResponseSchema>;
-
-export const releaseUploadCompleteRequestSchema = z.object({
-  release_id: releaseIdSchema,
-  size: z.number().int().nonnegative(),
-});
-export type ReleaseUploadCompleteRequest = z.infer<typeof releaseUploadCompleteRequestSchema>;
-
-export const releaseUploadCompleteResponseSchema = z.object({
-  success: z.literal(true),
-  release_id: nonEmptyString,
-  status: z.literal('completed'),
-});
-export type ReleaseUploadCompleteResponse = z.infer<typeof releaseUploadCompleteResponseSchema>;
-
-export const releaseUploadFailResponseSchema = z.object({
-  success: z.literal(true),
-  release_id: nonEmptyString,
-  status: z.literal('failed'),
-});
-export type ReleaseUploadFailResponse = z.infer<typeof releaseUploadFailResponseSchema>;
-
-// ─── Multipart Upload Lifecycle ──────────────────────────────────────────────
-
-export const releaseMultipartCreateRequestSchema = z.object({
-  name: releaseNameSchema,
-  filename: releaseFilenameSchema,
-  /** Defaults server-side to `application/octet-stream` when omitted. */
-  mime_type: nonEmptyString.optional(),
-  tags: releaseTagsSchema.optional().default([]),
-  notes: releaseNotesSchema,
-  force_update: z.boolean().optional().default(false),
-});
-export type ReleaseMultipartCreateRequest = z.input<typeof releaseMultipartCreateRequestSchema>;
-
-export const releaseMultipartCreateResponseSchema = z.object({
-  /** UniSource release id — the same id is used for sign/list/complete/abort. */
-  upload_id: nonEmptyString,
-  /** S3 (R2) multipart UploadId returned by CreateMultipartUpload. */
-  r2_upload_id: nonEmptyString,
-  /** R2 object key the parts are being uploaded against. */
-  key: nonEmptyString,
-  bucket: nonEmptyString,
-  expires_at: positiveInt,
-});
-export type ReleaseMultipartCreateResponse = z.infer<typeof releaseMultipartCreateResponseSchema>;
-
-export const releaseMultipartSignPartQuerySchema = z.object({
-  upload_id: releaseIdSchema,
-  part_number: z.coerce.number().int().min(1).max(10_000),
-});
-export type ReleaseMultipartSignPartQuery = z.input<typeof releaseMultipartSignPartQuerySchema>;
-
-export const releaseMultipartSignPartResponseSchema = z.object({
-  url: z.string().url(),
-  expires_at: positiveInt,
-});
-export type ReleaseMultipartSignPartResponse = z.infer<typeof releaseMultipartSignPartResponseSchema>;
-
-export const releaseMultipartListPartsQuerySchema = z.object({
-  upload_id: releaseIdSchema,
-});
-export type ReleaseMultipartListPartsQuery = z.input<typeof releaseMultipartListPartsQuerySchema>;
-
-export const releaseMultipartPartSchema = z.object({
-  PartNumber: z.number().int().min(1).max(10_000),
-  ETag: nonEmptyString,
-  Size: z.number().int().nonnegative(),
-});
-export type ReleaseMultipartPart = z.infer<typeof releaseMultipartPartSchema>;
-
-export const releaseMultipartListPartsResponseSchema = z.object({
-  parts: z.array(releaseMultipartPartSchema),
-});
-export type ReleaseMultipartListPartsResponse = z.infer<typeof releaseMultipartListPartsResponseSchema>;
-
-export const releaseMultipartCompleteRequestSchema = z.object({
-  upload_id: releaseIdSchema,
-  parts: z
-    .array(
-      z.object({
-        PartNumber: z.number().int().min(1).max(10_000),
-        ETag: nonEmptyString,
-      })
-    )
-    .min(1),
-});
-export type ReleaseMultipartCompleteRequest = z.input<typeof releaseMultipartCompleteRequestSchema>;
-
-export const releaseMultipartCompleteResponseSchema = releaseUploadCompleteResponseSchema;
-export type ReleaseMultipartCompleteResponse = z.infer<typeof releaseMultipartCompleteResponseSchema>;
-
-export const releaseMultipartAbortRequestSchema = z.object({
-  upload_id: releaseIdSchema,
-});
-export type ReleaseMultipartAbortRequest = z.input<typeof releaseMultipartAbortRequestSchema>;
-
-export const releaseMultipartAbortResponseSchema = releaseUploadFailResponseSchema;
-export type ReleaseMultipartAbortResponse = z.infer<typeof releaseMultipartAbortResponseSchema>;
-
-// ─── List ───────────────────────────────────────────────────────────────────
-
-export const releasesListQuerySchema = z.object({
-  limit: z.number().int().positive().max(100).optional(),
-  cursor: nonEmptyString.optional(),
-});
-export type ReleasesListQuery = z.infer<typeof releasesListQuerySchema>;
-
-export const releasesListResponseSchema = z.object({
-  items: z.array(releaseDTOSchema),
-  next_cursor: z.string().nullable(),
-});
-export type ReleasesListResponse = z.infer<typeof releasesListResponseSchema>;
-
-// ─── Update ─────────────────────────────────────────────────────────────────
-
-export const releaseUpdateRequestSchema = z
-  .object({
-    name: releaseNameSchema.optional(),
-    tags: releaseTagsSchema.optional(),
-    notes: releaseNotesSchema,
-    force_update: z.boolean().optional(),
-  })
-  .refine((body) => Object.values(body).some((value) => value !== undefined), {
-    message: 'At least one field must be provided',
-  });
-export type ReleaseUpdateRequest = z.infer<typeof releaseUpdateRequestSchema>;
-
-// ─── Delete ─────────────────────────────────────────────────────────────────
-
-export const releaseDeleteResponseSchema = z.object({
-  success: z.literal(true),
-  release_id: nonEmptyString,
-});
-export type ReleaseDeleteResponse = z.infer<typeof releaseDeleteResponseSchema>;
-
-// ─── Sync ───────────────────────────────────────────────────────────────────
-
-export const releaseSyncManifestSchema = z.object({
-  id: releaseIdSchema.optional(),
-  name: releaseNameSchema,
-  r2_key: releaseR2KeySchema,
-  size: z.number().int().nonnegative(),
-  tags: releaseTagsSchema.optional().default([]),
-  notes: releaseNotesSchema,
-  force_update: z.boolean().optional().default(false),
-});
-export type ReleaseSyncManifest = z.input<typeof releaseSyncManifestSchema>;
-
-export const releaseSyncRequestSchema = z.object({
-  releases: z.array(releaseSyncManifestSchema).min(1).max(100),
-});
-export type ReleaseSyncRequest = z.input<typeof releaseSyncRequestSchema>;
-
-export const releaseSyncResultSchema = z.object({
-  release_id: nonEmptyString,
-  success: z.boolean(),
-  status: uploadStatusSchema,
-});
-export type ReleaseSyncResult = z.infer<typeof releaseSyncResultSchema>;
-
-export const releaseSyncResponseSchema = z.object({
-  synced: z.number().int().nonnegative(),
-  results: z.array(releaseSyncResultSchema),
-});
-export type ReleaseSyncResponse = z.infer<typeof releaseSyncResponseSchema>;
-
-// ─── App-facing /app/releases/latest ─────────────────────────────────────────
-
-/**
- * Response of `GET /app/releases/latest?channel=...` — used by client apps to
- * discover the most recent completed release for a given distribution channel
- * (e.g. `stable`, `beta`). Includes a short-lived presigned download URL.
- */
-export const appReleaseLatestQuerySchema = z.object({
-  channel: nonEmptyString.optional().default('stable'),
-});
-export type AppReleaseLatestQuery = z.input<typeof appReleaseLatestQuerySchema>;
-
-export const appReleaseLatestResponseSchema = z.object({
-  id: nonEmptyString,
-  name: nonEmptyString,
-  size: z.number().int().nonnegative(),
-  r2_key: nonEmptyString,
-  tags: z.array(nonEmptyString),
-  notes: z.string().nullable(),
-  force_update: z.boolean(),
-  created_at: nonEmptyString,
-  download_url: z.string().url(),
-  download_url_expires_at: positiveInt,
-});
-export type AppReleaseLatestResponse = z.infer<typeof appReleaseLatestResponseSchema>;

package/src/services.ts

@@ -1,169 +0,0 @@
-import { z } from 'zod';
-import { nonEmptyString, positiveInt, recommendedUploadDestinationSchema, 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,
-  recommended_upload_destination: recommendedUploadDestinationSchema.optional(),
-  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>;
-
-// ─── Admin: Service Settings (split from limits) ──────────────────────────────
-
-/**
- * Separate settings endpoint driven by the Split-Button upload UI. Clients
- * can flip the recommended default upload destination per service without
- * disturbing quota-related fields.
- */
-export const adminServiceSettingsRequestSchema = z
-  .object({
-    recommended_upload_destination: recommendedUploadDestinationSchema.optional(),
-  })
-  .refine((v) => v.recommended_upload_destination !== undefined, {
-    message: 'At least one setting must be provided',
-  });
-export type AdminServiceSettingsRequest = z.infer<typeof adminServiceSettingsRequestSchema>;
-
-export const adminServiceSettingsResponseSchema = serviceDetailResponseSchema;
-export type AdminServiceSettingsResponse = z.infer<typeof adminServiceSettingsResponseSchema>;
-
-// ─── 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(),
-  actor_id: z.string().nullable().optional(),
-  target_user_id: z.string().nullable().optional(),
-  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>;
-
-// ─── Separate role/storage-limit update endpoints ─────────────────────────────
-
-export const adminUserRoleUpdateRequestSchema = z.object({
-  role: z.enum(['user', 'plus', 'admin']),
-});
-export type AdminUserRoleUpdateRequest = z.infer<typeof adminUserRoleUpdateRequestSchema>;
-
-export const adminUserStorageLimitUpdateRequestSchema = z.object({
-  limit_bytes: positiveInt.nullable(),
-});
-export type AdminUserStorageLimitUpdateRequest = z.infer<typeof adminUserStorageLimitUpdateRequestSchema>;

package/src/shareLinks.ts

@@ -1,109 +0,0 @@
-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>;
-
-// ─── Get single share link ────────────────────────────────────────────────────
-export const shareLinkDetailResponseSchema = z.object({
-  link: shareLinkSchema,
-});
-export type ShareLinkDetailResponse = z.infer<typeof shareLinkDetailResponseSchema>;
-
-// ─── Create via /shares (file_id in body) ────────────────────────────────────
-export const sharesCreateRequestSchema = z.object({
-  file_id: nonEmptyString,
-  name: z.string().trim().max(128).optional(),
-  expires_at: positiveInt.optional(),
-  max_downloads: positiveInt.optional(),
-  password: z.string().min(1).optional(),
-});
-export type SharesCreateRequest = z.infer<typeof sharesCreateRequestSchema>;