skedyul 0.2.113 → 0.2.115

package/dist/.build-stamp

@@ -1 +1 @@
-1769752729799
+1769757790864

package/dist/core/client.d.ts

@@ -381,6 +381,28 @@ export interface FileUrlResponse {
     /** ISO timestamp when the URL expires */
     expiresAt: string;
 }
+/**
+ * Parameters for file.upload
+ */
+export interface FileUploadParams {
+    /** File content - Buffer or base64-encoded string */
+    content: Buffer | string;
+    /** Original filename */
+    name: string;
+    /** MIME type of the file */
+    mimeType: string;
+    /** Optional path prefix for organization (e.g., 'attachments', 'images') */
+    path?: string;
+}
+/**
+ * Response from file.upload
+ */
+export interface FileUploadResult {
+    /** File ID (fl_xxx format) */
+    id: string;
+    /** Public URL (null for private files) */
+    url: string | null;
+}
 export declare const file: {
     /**
      * Get a temporary download URL for an app-scoped file.
@@ -398,6 +420,32 @@ export declare const file: {
      * ```
      */
     getUrl(fileId: string): Promise<FileUrlResponse>;
+    /**
+     * Upload file content and create a File record.
+     *
+     * Files are scoped to the app installation and stored privately.
+     * Use file.getUrl() to generate a temporary download URL when needed.
+     *
+     * @example
+     * ```ts
+     * // Upload a file from a Buffer
+     * const buffer = await downloadFromExternalUrl(url)
+     * const { id } = await file.upload({
+     *   content: buffer,
+     *   name: 'document.pdf',
+     *   mimeType: 'application/pdf',
+     * })
+     *
+     * // Upload with a path prefix for organization
+     * const { id } = await file.upload({
+     *   content: imageBuffer,
+     *   name: 'photo.jpg',
+     *   mimeType: 'image/jpeg',
+     *   path: 'attachments',
+     * })
+     * ```
+     */
+    upload(params: FileUploadParams): Promise<FileUploadResult>;
 };
 /**
  * Response from webhook.create

package/dist/core/client.js

@@ -427,6 +427,44 @@ exports.file = {
         });
         return data;
     },
+    /**
+     * Upload file content and create a File record.
+     *
+     * Files are scoped to the app installation and stored privately.
+     * Use file.getUrl() to generate a temporary download URL when needed.
+     *
+     * @example
+     * ```ts
+     * // Upload a file from a Buffer
+     * const buffer = await downloadFromExternalUrl(url)
+     * const { id } = await file.upload({
+     *   content: buffer,
+     *   name: 'document.pdf',
+     *   mimeType: 'application/pdf',
+     * })
+     *
+     * // Upload with a path prefix for organization
+     * const { id } = await file.upload({
+     *   content: imageBuffer,
+     *   name: 'photo.jpg',
+     *   mimeType: 'image/jpeg',
+     *   path: 'attachments',
+     * })
+     * ```
+     */
+    async upload(params) {
+        // Convert Buffer to base64 string for transport
+        const content = typeof params.content === 'string'
+            ? params.content
+            : params.content.toString('base64');
+        const { data } = await callCore('file.upload', {
+            content,
+            name: params.name,
+            mimeType: params.mimeType,
+            ...(params.path ? { path: params.path } : {}),
+        });
+        return data;
+    },
 };
 exports.webhook = {
     /**

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export * from './schemas';
 export { server } from './server';
 export { z };
 export { workplace, communicationChannel, instance, token, file, webhook, resource, contactAssociationLink, configure, getConfig, runWithConfig, } from './core/client';
-export type { InstanceContext, InstanceData, InstanceMeta, InstancePagination, InstanceListResult, InstanceListArgs, FileUrlResponse, WebhookCreateResult, WebhookListItem, WebhookDeleteByNameOptions, WebhookListOptions, ResourceLinkParams, ResourceLinkResult, ContactAssociationLinkCreateParams, ContactAssociationLinkCreateResult, } from './core/client';
+export type { InstanceContext, InstanceData, InstanceMeta, InstancePagination, InstanceListResult, InstanceListArgs, FileUrlResponse, FileUploadParams, FileUploadResult, WebhookCreateResult, WebhookListItem, WebhookDeleteByNameOptions, WebhookListOptions, ResourceLinkParams, ResourceLinkResult, ContactAssociationLinkCreateParams, ContactAssociationLinkCreateResult, } from './core/client';
 declare const _default: {
     z: typeof z;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "0.2.113",
+  "version": "0.2.115",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",