@plyaz/types 1.30.0 → 1.31.1

package/dist/api/index.cjs

@@ -1,5 +1,7 @@
 'use strict';
 
+var zod = require('zod');
+
 // @plyaz package - Built with tsup
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -502,6 +504,204 @@ var PUB_SUB_EVENT = {
   RequestError: "request:error",
   RequestAbort: "request:abort"
 };
+var PDF_SCALE_MIN = 0.1;
+var PDF_SCALE_MAX = 2;
+var MAX_BULK_UPLOAD_CONCURRENCY = 10;
+var OutputFormatSchema = zod.z.enum(["pdf", "docx", "xlsx", "html"]);
+var AccessLevelSchema = zod.z.enum(["public", "private", "protected"]);
+var PdfOptionsSchema = zod.z.object({
+  format: zod.z.enum(["A4", "Letter", "Legal"]).optional(),
+  landscape: zod.z.boolean().optional(),
+  margin: zod.z.object({
+    top: zod.z.string().optional(),
+    right: zod.z.string().optional(),
+    bottom: zod.z.string().optional(),
+    left: zod.z.string().optional()
+  }).optional(),
+  displayHeaderFooter: zod.z.boolean().optional(),
+  headerTemplate: zod.z.string().optional(),
+  footerTemplate: zod.z.string().optional(),
+  printBackground: zod.z.boolean().optional(),
+  scale: zod.z.number().min(PDF_SCALE_MIN).max(PDF_SCALE_MAX).optional()
+}).optional();
+var UploadFileRequestSchema = zod.z.object({
+  // Direct File Upload (base64)
+  base64: zod.z.string().optional(),
+  mimeType: zod.z.string().optional(),
+  filename: zod.z.string().optional(),
+  // Template-Based Generation
+  templateId: zod.z.string().optional(),
+  templateData: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+  outputFormat: OutputFormatSchema.optional(),
+  locale: zod.z.string().optional(),
+  pdfOptions: PdfOptionsSchema,
+  // Path Generation & Storage (required)
+  category: zod.z.string(),
+  entityType: zod.z.string(),
+  entityId: zod.z.string(),
+  // Optional Metadata
+  accessLevel: AccessLevelSchema.optional(),
+  customMetadata: zod.z.record(zod.z.string(), zod.z.unknown()).optional(),
+  tags: zod.z.array(zod.z.string()).optional(),
+  customPath: zod.z.string().optional(),
+  ttl: zod.z.number().positive().optional(),
+  immutable: zod.z.boolean().optional(),
+  // Processing Options
+  extractMetadata: zod.z.boolean().optional(),
+  virusScan: zod.z.boolean().optional(),
+  processMedia: zod.z.boolean().optional()
+}).refine(
+  (data) => {
+    return Boolean(data.base64) || Boolean(data.templateId);
+  },
+  {
+    message: "Either base64 content or templateId must be provided"
+  }
+).refine(
+  (data) => {
+    if (data.base64 && !data.mimeType) {
+      return false;
+    }
+    return true;
+  },
+  {
+    message: "mimeType is required when base64 content is provided"
+  }
+);
+var FileVariantSchema = zod.z.object({
+  url: zod.z.string().url(),
+  size: zod.z.number().nonnegative(),
+  mimeType: zod.z.string()
+});
+var UploadFileResponseSchema = zod.z.object({
+  // Core identifiers
+  id: zod.z.string(),
+  key: zod.z.string(),
+  filename: zod.z.string(),
+  mimeType: zod.z.string(),
+  size: zod.z.number().nonnegative(),
+  checksum: zod.z.string().optional(),
+  // URLs
+  url: zod.z.string().optional(),
+  publicUrl: zod.z.string().optional(),
+  signedUrl: zod.z.string().optional(),
+  // Storage Info
+  bucket: zod.z.string(),
+  adapter: zod.z.string().optional(),
+  entityType: zod.z.string().optional(),
+  entityId: zod.z.string().optional(),
+  category: zod.z.string().optional(),
+  // Timestamps
+  uploadedAt: zod.z.string(),
+  expiresAt: zod.z.string().optional(),
+  // Variants
+  variants: zod.z.record(zod.z.string(), FileVariantSchema).optional(),
+  // Warnings
+  warnings: zod.z.array(zod.z.string()).optional()
+});
+var UploadFileItemSchema = UploadFileRequestSchema;
+var UploadFilesRequestSchema = zod.z.object({
+  /** Array of files to upload */
+  files: zod.z.array(UploadFileItemSchema).min(1, "At least one file is required"),
+  /** Options for bulk upload */
+  options: zod.z.object({
+    /** Max concurrent uploads (default: 3, max: 10) */
+    concurrency: zod.z.number().min(1).max(MAX_BULK_UPLOAD_CONCURRENCY).optional(),
+    /** Continue uploading remaining files if one fails */
+    continueOnError: zod.z.boolean().optional(),
+    /** Use queue for background processing */
+    useQueue: zod.z.boolean().optional()
+  }).optional()
+});
+var UploadFileResultSchema = zod.z.object({
+  /** Index in original files array */
+  index: zod.z.number().nonnegative(),
+  /** Whether this file uploaded successfully */
+  success: zod.z.boolean(),
+  /** Upload result (when success=true) */
+  data: UploadFileResponseSchema.optional(),
+  /** Error message (when success=false) */
+  error: zod.z.string().optional()
+});
+var UploadFilesResponseSchema = zod.z.object({
+  /** Individual results for each file */
+  results: zod.z.array(UploadFileResultSchema),
+  /** Summary statistics */
+  summary: zod.z.object({
+    total: zod.z.number().nonnegative(),
+    succeeded: zod.z.number().nonnegative(),
+    failed: zod.z.number().nonnegative()
+  }),
+  /** Whether all files uploaded successfully */
+  allSucceeded: zod.z.boolean()
+});
+var GenerateDocumentRequestSchema = zod.z.object({
+  templateId: zod.z.string(),
+  templateData: zod.z.record(zod.z.string(), zod.z.unknown()),
+  outputFormat: OutputFormatSchema.optional().default("pdf"),
+  locale: zod.z.string().optional(),
+  pdfOptions: PdfOptionsSchema
+});
+var GenerateDocumentResponseSchema = zod.z.object({
+  buffer: zod.z.string(),
+  // base64 encoded
+  size: zod.z.number().nonnegative()
+});
+var GetFileParamsSchema = zod.z.object({
+  id: zod.z.string().uuid()
+});
+var GetFileRequestSchema = GetFileParamsSchema;
+var GetFileResponseSchema = zod.z.object({
+  id: zod.z.string().uuid(),
+  key: zod.z.string(),
+  filename: zod.z.string(),
+  mimeType: zod.z.string(),
+  size: zod.z.number().nonnegative(),
+  checksum: zod.z.string().optional(),
+  url: zod.z.string().optional(),
+  publicUrl: zod.z.string().optional(),
+  signedUrl: zod.z.string().optional(),
+  bucket: zod.z.string(),
+  entityType: zod.z.string().optional(),
+  entityId: zod.z.string().optional(),
+  category: zod.z.string().optional(),
+  uploadedAt: zod.z.string(),
+  expiresAt: zod.z.string().optional()
+});
+var DownloadFileParamsSchema = zod.z.object({
+  id: zod.z.string().uuid()
+});
+var DownloadFileRequestSchema = DownloadFileParamsSchema;
+var DownloadFileResponseSchema = zod.z.object({
+  buffer: zod.z.string(),
+  // base64 encoded
+  size: zod.z.number().nonnegative(),
+  mimeType: zod.z.string(),
+  filename: zod.z.string().optional()
+});
+var DeleteFileParamsSchema = zod.z.object({
+  id: zod.z.string().uuid()
+});
+var DeleteFileRequestSchema = DeleteFileParamsSchema;
+var DeleteFileResponseSchema = zod.z.object({
+  success: zod.z.boolean()
+});
+var GetSignedUrlParamsSchema = zod.z.object({
+  id: zod.z.string().uuid()
+});
+var GetSignedUrlQuerySchema = zod.z.object({
+  expiresIn: zod.z.number().positive().optional()
+});
+var GetSignedUrlRequestSchema = zod.z.object({
+  /** File ID (UUID from media table) */
+  id: zod.z.string().uuid(),
+  /** Optional query parameters */
+  query: GetSignedUrlQuerySchema.optional()
+});
+var GetSignedUrlResponseSchema = zod.z.object({
+  url: zod.z.string().url(),
+  expiresAt: zod.z.string()
+});
 
 // src/errors/enums.ts
 var ERROR_SEVERITY = {
@@ -5645,6 +5845,7 @@ exports.ALERT_SEVERITIES = ALERT_SEVERITIES;
 exports.ALERT_TYPES = ALERT_TYPES;
 exports.ALL_EVENTS = ALL_EVENTS;
 exports.API_ERROR_CODES = API_ERROR_CODES;
+exports.AccessLevelSchema = AccessLevelSchema;
 exports.CACHE_DURATION_MS = CACHE_DURATION_MS;
 exports.CACHE_EVENTS = CACHE_EVENTS;
 exports.CHANGE_TYPES = CHANGE_TYPES;
@@ -5659,6 +5860,12 @@ exports.DATA_SAVER_PRESETS = DATA_SAVER_PRESETS;
 exports.DEBUGGER_CONFIG_SOURCES = DEBUGGER_CONFIG_SOURCES;
 exports.DEBUG_EVENTS = DEBUG_EVENTS;
 exports.DEFAULT_THRESHOLDS = DEFAULT_THRESHOLDS;
+exports.DeleteFileParamsSchema = DeleteFileParamsSchema;
+exports.DeleteFileRequestSchema = DeleteFileRequestSchema;
+exports.DeleteFileResponseSchema = DeleteFileResponseSchema;
+exports.DownloadFileParamsSchema = DownloadFileParamsSchema;
+exports.DownloadFileRequestSchema = DownloadFileRequestSchema;
+exports.DownloadFileResponseSchema = DownloadFileResponseSchema;
 exports.ERROR_CATEGORY = ERROR_CATEGORY;
 exports.ERROR_DEFINITIONS = ERROR_DEFINITIONS;
 exports.ERROR_EVENTS = ERROR_EVENTS;
@@ -5671,6 +5878,16 @@ exports.EVENT_PRIORITY_MAP = EVENT_PRIORITY_MAP;
 exports.EVENT_SCOPES = EVENT_SCOPES;
 exports.EVENT_SCOPES_WITH_TEMPORARY = EVENT_SCOPES_WITH_TEMPORARY;
 exports.FACTORY_OPERATIONS = FACTORY_OPERATIONS;
+exports.FileVariantSchema = FileVariantSchema;
+exports.GenerateDocumentRequestSchema = GenerateDocumentRequestSchema;
+exports.GenerateDocumentResponseSchema = GenerateDocumentResponseSchema;
+exports.GetFileParamsSchema = GetFileParamsSchema;
+exports.GetFileRequestSchema = GetFileRequestSchema;
+exports.GetFileResponseSchema = GetFileResponseSchema;
+exports.GetSignedUrlParamsSchema = GetSignedUrlParamsSchema;
+exports.GetSignedUrlQuerySchema = GetSignedUrlQuerySchema;
+exports.GetSignedUrlRequestSchema = GetSignedUrlRequestSchema;
+exports.GetSignedUrlResponseSchema = GetSignedUrlResponseSchema;
 exports.HANDLER_SCOPES = HANDLER_SCOPES;
 exports.HEADER_EVENTS = HEADER_EVENTS;
 exports.HEADER_STAGES = HEADER_STAGES;
@@ -5682,10 +5899,12 @@ exports.NETWORK_EVENTS = NETWORK_EVENTS;
 exports.NETWORK_QUALITY = NETWORK_QUALITY;
 exports.NetworkPresetNames = NetworkPresetNames;
 exports.OPERATIONS = COMMON_OPERATIONS;
+exports.OutputFormatSchema = OutputFormatSchema;
 exports.PACKAGE_STATUS_CODES = INTERNAL_STATUS_CODES;
 exports.PERFORMANCE_EVENTS = PERFORMANCE_EVENTS;
 exports.PRIORITY_LEVEL = PRIORITY_LEVEL;
 exports.PUB_SUB_EVENT = PUB_SUB_EVENT;
+exports.PdfOptionsSchema = PdfOptionsSchema;
 exports.QUEUE_OPERATIONS = QUEUE_OPERATIONS;
 exports.REGIONAL_CONFIDENCE_LEVELS = REGIONAL_CONFIDENCE_LEVELS;
 exports.REGION_STORAGE_KEY = REGION_STORAGE_KEY;
@@ -5696,6 +5915,12 @@ exports.STORAGE_TYPES = COMMON_STORAGE_TYPES;
 exports.TRACKING_PHASES = TRACKING_PHASES;
 exports.UNIFIED_OPERATIONS = UNIFIED_OPERATIONS;
 exports.UPDATE_STRATEGIES = UPDATE_STRATEGIES;
+exports.UploadFileItemSchema = UploadFileItemSchema;
+exports.UploadFileRequestSchema = UploadFileRequestSchema;
+exports.UploadFileResponseSchema = UploadFileResponseSchema;
+exports.UploadFileResultSchema = UploadFileResultSchema;
+exports.UploadFilesRequestSchema = UploadFilesRequestSchema;
+exports.UploadFilesResponseSchema = UploadFilesResponseSchema;
 exports.VALIDATION_RANGES = VALIDATION_RANGES;
 exports.isValidConfigSource = isValidConfigSource;
 exports.isValidHistoryType = isValidHistoryType;