@plyaz/types 1.41.3 → 1.42.0

package/dist/core/hooks/files/download.d.ts

@@ -3,6 +3,7 @@
  *
  * Types for useFileDownload hook.
  */
+import type { ServiceOptions } from '../../../api';
 /**
  * Options for useFileDownload hook
  *
@@ -21,10 +22,15 @@ export interface CoreFileDownloadOptions {
  *
  * Note: Errors propagate through global error handling (error boundaries,
  * global error alert store). Results are returned from the Promise.
+ *
+ * Download accepts optional ServiceOptions for debugging/auditing:
+ * - `apiConfig.unifiedStrategy` - Override the unified strategy
+ * - `apiConfig.timeout` - Override timeout
+ * - etc.
  */
 export interface CoreFileDownloadResult {
     /** Download a file by ID */
-    download: (fileId: string, options?: CoreFileDownloadOptions) => Promise<Blob | null>;
+    download: (fileId: string, options?: CoreFileDownloadOptions, serviceOptions?: ServiceOptions) => Promise<Blob | null>;
     /** Whether currently downloading */
     isDownloading: boolean;
     /** Current download ID (if any) */

package/dist/core/hooks/files/upload.d.ts

@@ -4,7 +4,7 @@
  * Types for useFileUpload hook.
  * Uses Pick to extend from existing API types where applicable.
  */
-import type { UploadFileRequest, GenerateDocumentRequest } from '../../../api';
+import type { UploadFileRequest, GenerateDocumentRequest, ServiceOptions } from '../../../api';
 import type { FILE_CATEGORY, ENTITY_TYPE } from '../../../storage/enums';
 /**
  * Options for useFileUpload hook - direct file upload
@@ -72,18 +72,23 @@ export interface CoreBulkTemplateUploadOptions {
  *
  * Note: Errors propagate through global error handling (error boundaries,
  * global error alert store). Results are returned from the Promise.
+ *
+ * All methods accept optional ServiceOptions for debugging/auditing:
+ * - `apiConfig.unifiedStrategy` - Override the unified strategy
+ * - `apiConfig.timeout` - Override timeout
+ * - etc.
  */
 export interface CoreFileUploadResult {
     /** Upload a file directly */
-    upload: (file: File, options?: CoreFileUploadOptions) => Promise<unknown>;
+    upload: (file: File, options?: CoreFileUploadOptions, serviceOptions?: ServiceOptions) => Promise<unknown>;
     /** Upload multiple files directly */
-    uploadMultiple: (files: File[], options?: CoreFileUploadOptions) => Promise<unknown[]>;
+    uploadMultiple: (files: File[], options?: CoreFileUploadOptions, serviceOptions?: ServiceOptions) => Promise<unknown[]>;
     /** Generate document from template and upload to storage */
-    uploadFromTemplate: (options: CoreTemplateUploadOptions) => Promise<unknown>;
+    uploadFromTemplate: (options: CoreTemplateUploadOptions, serviceOptions?: ServiceOptions) => Promise<unknown>;
     /** Generate multiple documents from templates and upload to storage */
-    uploadMultipleFromTemplate: (options: CoreBulkTemplateUploadOptions) => Promise<unknown[]>;
+    uploadMultipleFromTemplate: (options: CoreBulkTemplateUploadOptions, serviceOptions?: ServiceOptions) => Promise<unknown[]>;
     /** Generate document from template (no upload - returns buffer for client download) */
-    generate: (options: CoreGenerateOptions) => Promise<{
+    generate: (options: CoreGenerateOptions, serviceOptions?: ServiceOptions) => Promise<{
         buffer: string;
         size: number;
     }>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plyaz/types",
-  "version": "1.41.3",
+  "version": "1.42.0",
   "author": "Redeemer Pace",
   "license": "ISC",
   "description": "Provides shared TypeScript types and schema utilities for validation and parsing in the @playz ecosystem.",