rcs-js 2.0.0-rc.11 → 2.0.0-rc.13

package/dist/cjs/api/types/RcsButtonScheduleEvent.d.ts

@@ -13,6 +13,8 @@ export interface RcsButtonScheduleEvent {
     eventStartTime: string;
     /** Title of the event. */
     eventTitle: string;
+    /** Optional additional data to attach to this button. */
+    metadata?: string;
     /** Display text for the button. */
     title: string;
 }

package/dist/cjs/api/types/RcsButtonSendLocation.d.ts

@@ -7,6 +7,8 @@
 export interface RcsButtonSendLocation {
     /** Geographic coordinates of the location to share. */
     latLong: RcsButtonSendLocation.LatLong;
+    /** Optional additional data to attach to this button. */
+    metadata?: string;
     /** Display text for the button. */
     title: string;
 }

package/dist/cjs/api/types/RcsButtonTrigger.d.ts

@@ -5,8 +5,8 @@
  * Button that sends custom data back to your application when tapped by the recipient.
  */
 export interface RcsButtonTrigger {
-    /** Additional data attached to the button interaction. */
-    metadata: string;
+    /** Optional additional data to attach to this button. */
+    metadata?: string;
     /** Custom data sent to your webhook when the button is tapped. Use this to identify the user's choice. */
     payload: string;
     /** Display text for the button. */

package/dist/cjs/api/types/RefreshedFile.d.ts

@@ -0,0 +1,9 @@
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+export interface RefreshedFile {
+    /** The original file URI that was provided in the request. */
+    original: string;
+    /** The new refreshed presigned URL that expires in one hour. */
+    refreshed: string;
+}

package/dist/cjs/api/types/{Rcs.d.ts → RichMessage.d.ts}

@@ -2,7 +2,7 @@
  * This file was auto-generated by Fern from our API Definition.
  */
 import * as Pinnacle from "../index.js";
-export type Rcs = 
+export type RichMessage = 
 /**
  * Send a text RCS message with optional quick reply buttons. */
 Pinnacle.RichTextMessage

package/dist/cjs/api/types/RichMessage.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * This file was auto-generated by Fern from our API Definition.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/types/index.d.ts

@@ -59,9 +59,9 @@ export * from "./RcsMediaDetailsContent.js";
 export * from "./RcsMediaContent.js";
 export * from "./RcsCardsContent.js";
 export * from "./RcsContent.js";
-export * from "./ClickAction.js";
+export * from "./ButtonClickedData.js";
 export * from "./LocationShareAction.js";
-export * from "./InboundButton.js";
+export * from "./ButtonClicked.js";
 export * from "./MessageContent.js";
 export * from "./MessageMethodEnum.js";
 export * from "./MessageStatusEnum.js";
@@ -78,7 +78,7 @@ export * from "./RichTextMessage.js";
 export * from "./RichMediaMessage.js";
 export * from "./RcsCards.js";
 export * from "./RichCardsMessage.js";
-export * from "./Rcs.js";
+export * from "./RichMessage.js";
 export * from "./SentRcsDetails.js";
 export * from "./SmsValidationResult.js";
 export * from "./MmsValidationResult.js";
@@ -119,6 +119,7 @@ export * from "./ShortenedUrl.js";
 export * from "./LinkClickEvent.js";
 export * from "./ShortenedUrlWithClickData.js";
 export * from "./UploadResults.js";
+export * from "./RefreshedFile.js";
 export * from "./VcardAddress.js";
 export * from "./VcardPhone.js";
 export * from "./VcardEmail.js";
@@ -128,3 +129,4 @@ export * from "./VCardData.js";
 export * from "./VcardResource.js";
 export * from "./Webhooks.js";
 export * from "./WebhookResult.js";
+export * from "./MessageEvent.js";

package/dist/cjs/api/types/index.js

@@ -75,9 +75,9 @@ __exportStar(require("./RcsMediaDetailsContent.js"), exports);
 __exportStar(require("./RcsMediaContent.js"), exports);
 __exportStar(require("./RcsCardsContent.js"), exports);
 __exportStar(require("./RcsContent.js"), exports);
-__exportStar(require("./ClickAction.js"), exports);
+__exportStar(require("./ButtonClickedData.js"), exports);
 __exportStar(require("./LocationShareAction.js"), exports);
-__exportStar(require("./InboundButton.js"), exports);
+__exportStar(require("./ButtonClicked.js"), exports);
 __exportStar(require("./MessageContent.js"), exports);
 __exportStar(require("./MessageMethodEnum.js"), exports);
 __exportStar(require("./MessageStatusEnum.js"), exports);
@@ -94,7 +94,7 @@ __exportStar(require("./RichTextMessage.js"), exports);
 __exportStar(require("./RichMediaMessage.js"), exports);
 __exportStar(require("./RcsCards.js"), exports);
 __exportStar(require("./RichCardsMessage.js"), exports);
-__exportStar(require("./Rcs.js"), exports);
+__exportStar(require("./RichMessage.js"), exports);
 __exportStar(require("./SentRcsDetails.js"), exports);
 __exportStar(require("./SmsValidationResult.js"), exports);
 __exportStar(require("./MmsValidationResult.js"), exports);
@@ -135,6 +135,7 @@ __exportStar(require("./ShortenedUrl.js"), exports);
 __exportStar(require("./LinkClickEvent.js"), exports);
 __exportStar(require("./ShortenedUrlWithClickData.js"), exports);
 __exportStar(require("./UploadResults.js"), exports);
+__exportStar(require("./RefreshedFile.js"), exports);
 __exportStar(require("./VcardAddress.js"), exports);
 __exportStar(require("./VcardPhone.js"), exports);
 __exportStar(require("./VcardEmail.js"), exports);
@@ -144,3 +145,4 @@ __exportStar(require("./VCardData.js"), exports);
 __exportStar(require("./VcardResource.js"), exports);
 __exportStar(require("./Webhooks.js"), exports);
 __exportStar(require("./WebhookResult.js"), exports);
+__exportStar(require("./MessageEvent.js"), exports);

package/dist/cjs/index.d.ts

@@ -1,4 +1,4 @@
 export * as Pinnacle from "./api/index.js";
-export { PinnacleClient } from "./Client.js";
+export { PinnacleClient } from "./wrapper/PinnacleClient.js";
 export { PinnacleEnvironment } from "./environments.js";
 export { PinnacleError, PinnacleTimeoutError } from "./errors/index.js";

package/dist/cjs/index.js

@@ -35,8 +35,8 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PinnacleTimeoutError = exports.PinnacleError = exports.PinnacleEnvironment = exports.PinnacleClient = exports.Pinnacle = void 0;
 exports.Pinnacle = __importStar(require("./api/index.js"));
-var Client_js_1 = require("./Client.js");
-Object.defineProperty(exports, "PinnacleClient", { enumerable: true, get: function () { return Client_js_1.PinnacleClient; } });
+var PinnacleClient_js_1 = require("./wrapper/PinnacleClient.js");
+Object.defineProperty(exports, "PinnacleClient", { enumerable: true, get: function () { return PinnacleClient_js_1.PinnacleClient; } });
 var environments_js_1 = require("./environments.js");
 Object.defineProperty(exports, "PinnacleEnvironment", { enumerable: true, get: function () { return environments_js_1.PinnacleEnvironment; } });
 var index_js_1 = require("./errors/index.js");

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "2.0.0-rc.11";
+export declare const SDK_VERSION = "2.0.0-rc.13";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "2.0.0-rc.11";
+exports.SDK_VERSION = "2.0.0-rc.13";

package/dist/cjs/wrapper/PinnacleClient.d.ts

@@ -0,0 +1,9 @@
+import { PinnacleClient as FernClient } from "../Client.js";
+import { EnhancedTools } from "./tools/Client.js";
+import { EnhancedMessages } from "./messages/Client.js";
+export declare class PinnacleClient extends FernClient {
+    protected _tools: EnhancedTools | undefined;
+    protected _messages: EnhancedMessages | undefined;
+    get tools(): EnhancedTools;
+    get messages(): EnhancedMessages;
+}

package/dist/cjs/wrapper/PinnacleClient.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PinnacleClient = void 0;
+const Client_js_1 = require("../Client.js");
+const Client_js_2 = require("./tools/Client.js");
+const Client_js_3 = require("./messages/Client.js");
+class PinnacleClient extends Client_js_1.PinnacleClient {
+    get tools() {
+        var _a;
+        return ((_a = this._tools) !== null && _a !== void 0 ? _a : (this._tools = new Client_js_2.EnhancedTools(this._options)));
+    }
+    get messages() {
+        var _a;
+        return ((_a = this._messages) !== null && _a !== void 0 ? _a : (this._messages = new Client_js_3.EnhancedMessages(this._options)));
+    }
+}
+exports.PinnacleClient = PinnacleClient;

package/dist/cjs/wrapper/messages/Client.d.ts

@@ -0,0 +1,13 @@
+import { Messages } from "../../api/resources/messages/client/Client.js";
+import * as Pinnacle from "../../api/index.js";
+interface ExpressLikeRequest {
+    headers: Record<string, string | string[] | undefined>;
+    body?: any;
+    get?: (name: string) => string | undefined;
+    protocol?: string;
+    originalUrl?: string;
+}
+export declare class EnhancedMessages extends Messages {
+    process(req: Request | ExpressLikeRequest, secret?: string): Promise<Pinnacle.MessageEvent>;
+}
+export {};

package/dist/cjs/wrapper/messages/Client.js

@@ -0,0 +1,49 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnhancedMessages = void 0;
+const Client_js_1 = require("../../api/resources/messages/client/Client.js");
+const index_js_1 = require("../../api/errors/index.js");
+class EnhancedMessages extends Client_js_1.Messages {
+    process(req, secret) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const signingSecret = secret || process.env.PINNACLE_SIGNING_SECRET;
+            let headerSecret;
+            let body;
+            if (req instanceof Request) {
+                headerSecret =
+                    ((_a = req.headers) === null || _a === void 0 ? void 0 : _a.get("PINNACLE-SIGNING-SECRET")) || ((_b = req.headers) === null || _b === void 0 ? void 0 : _b.get("pinnacle-signing-secret")) || undefined;
+                body = yield req.json();
+            }
+            else {
+                const headers = req.headers;
+                headerSecret = headers["pinnacle-signing-secret"];
+                body = req.body;
+            }
+            if (!signingSecret) {
+                throw new index_js_1.UnauthorizedError({
+                    error: "Make sure to set the PINNACLE-SIGNING-SECRET environment variable or pass the secret as an argument to the process method",
+                });
+            }
+            if (!headerSecret) {
+                throw new index_js_1.UnauthorizedError({
+                    error: "Failed to get the PINNACLE-SIGNING-SECRET header from request",
+                });
+            }
+            if (headerSecret !== signingSecret) {
+                throw new index_js_1.UnauthorizedError({ error: "Invalid webhook signature" });
+            }
+            return body;
+        });
+    }
+}
+exports.EnhancedMessages = EnhancedMessages;

package/dist/cjs/wrapper/tools/Client.d.ts

@@ -0,0 +1,6 @@
+import { Tools } from '../../api/resources/tools/client/Client.js';
+import { FileUploader } from './FileUploader.js';
+export declare class EnhancedTools extends Tools {
+    protected _fileUploader: FileUploader | undefined;
+    get file(): FileUploader;
+}

package/dist/cjs/wrapper/tools/Client.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnhancedTools = void 0;
+const Client_js_1 = require("../../api/resources/tools/client/Client.js");
+const FileUploader_js_1 = require("./FileUploader.js");
+class EnhancedTools extends Client_js_1.Tools {
+    get file() {
+        var _a;
+        return ((_a = this._fileUploader) !== null && _a !== void 0 ? _a : (this._fileUploader = new FileUploader_js_1.FileUploader(this._options)));
+    }
+}
+exports.EnhancedTools = EnhancedTools;

package/dist/cjs/wrapper/tools/FileUploader.d.ts

@@ -0,0 +1,15 @@
+import { File_ } from "../../api/resources/tools/resources/file/client/Client.js";
+import { UploadFileParams } from "../../api/resources/tools/resources/file/client/requests/index.js";
+export declare class FileUploader extends File_ {
+    /**
+     * Upload a file from a file path (Node.js) or File object (browser)
+     * @param fileInput - File path string (Node.js) or File object (browser)
+     * @param options - Upload options
+     * @returns The download URL of the uploaded file
+     */
+    uploadFromPath(fileInput: string | File, options?: {
+        name?: string;
+        options?: UploadFileParams.Options;
+    }): Promise<string>;
+    private getMimeType;
+}

package/dist/cjs/wrapper/tools/FileUploader.js

@@ -0,0 +1,162 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileUploader = void 0;
+const mime = __importStar(require("mime-types"));
+const Client_js_1 = require("../../api/resources/tools/resources/file/client/Client.js");
+const index_js_1 = require("../../api/errors/index.js");
+class FileUploader extends Client_js_1.File_ {
+    /**
+     * Upload a file from a file path (Node.js) or File object (browser)
+     * @param fileInput - File path string (Node.js) or File object (browser)
+     * @param options - Upload options
+     * @returns The download URL of the uploaded file
+     */
+    uploadFromPath(fileInput, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let size;
+            let fileName;
+            let contentType;
+            let blob;
+            if (typeof window === "undefined") {
+                if (typeof fileInput !== "string") {
+                    throw new index_js_1.BadRequestError({ message: "In Node.js, fileInput must be a file path string" });
+                }
+                const fs = yield Promise.resolve().then(() => __importStar(require("fs")));
+                const path = yield Promise.resolve().then(() => __importStar(require("path")));
+                const filePath = fileInput;
+                let stats;
+                try {
+                    stats = yield fs.promises.stat(filePath);
+                }
+                catch (error) {
+                    if (error.code === "ENOENT") {
+                        throw new index_js_1.NotFoundError({ error: `File not found: ${filePath}` });
+                    }
+                    throw new index_js_1.InternalServerError({ error: `Failed to access file: ${error.message}` });
+                }
+                if (stats.isDirectory()) {
+                    throw new index_js_1.BadRequestError({ message: `Path is a directory, not a file: ${filePath}` });
+                }
+                size = stats.size;
+                fileName = (options === null || options === void 0 ? void 0 : options.name) || path.default.basename(filePath);
+                contentType = this.getMimeType(filePath);
+                const fileBuffer = yield fs.promises.readFile(filePath);
+                const arrayBuffer = new Uint8Array(fileBuffer).buffer;
+                blob = new Blob([arrayBuffer], { type: contentType });
+            }
+            else {
+                if (!(fileInput instanceof File)) {
+                    throw new index_js_1.BadRequestError({ message: "In browser, fileInput must be a File object" });
+                }
+                const file = fileInput;
+                size = file.size;
+                fileName = (options === null || options === void 0 ? void 0 : options.name) || file.name;
+                contentType = file.type || this.getMimeType(file.name);
+                blob = file;
+            }
+            const uploadParams = {
+                contentType,
+                size,
+                name: fileName,
+                options: options === null || options === void 0 ? void 0 : options.options,
+            };
+            const uploadResult = yield this.upload(uploadParams);
+            if (uploadResult.uploadUrl) {
+                yield fetch(uploadResult.uploadUrl, {
+                    method: "PUT",
+                    body: blob,
+                    headers: {
+                        "Content-Type": contentType,
+                    },
+                });
+            }
+            return uploadResult.downloadUrl;
+        });
+    }
+    getMimeType(filePath) {
+        const mimeType = mime.lookup(filePath);
+        if (!mimeType) {
+            return "application/octet-stream";
+        }
+        const supportedTypes = new Set([
+            "audio/mpeg",
+            "audio/mp4",
+            "audio/ogg",
+            "audio/aac",
+            "audio/webm",
+            "audio/wav",
+            "audio/3gpp",
+            "audio/amr",
+            "video/mp4",
+            "video/mpeg",
+            "video/quicktime",
+            "video/webm",
+            "video/3gpp",
+            "video/H264",
+            "video/x-m4v",
+            "image/jpeg",
+            "image/png",
+            "image/gif",
+            "image/bmp",
+            "image/tiff",
+            "image/webp",
+            "application/pdf",
+            "text/csv",
+            "application/rtf",
+            "text/vcard",
+            "text/calendar",
+        ]);
+        if (supportedTypes.has(mimeType)) {
+            return mimeType;
+        }
+        const baseType = mimeType.split("/")[0];
+        if (["audio", "video", "image"].includes(baseType)) {
+            console.warn(`MIME type ${mimeType} may not be fully supported. Proceeding anyway.`);
+            return mimeType;
+        }
+        return "application/octet-stream";
+    }
+}
+exports.FileUploader = FileUploader;

package/dist/esm/Client.mjs

@@ -18,8 +18,8 @@ export class PinnacleClient {
         this._options = Object.assign(Object.assign({}, _options), { headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "rcs-js",
-                "X-Fern-SDK-Version": "2.0.0-rc.11",
-                "User-Agent": "rcs-js/2.0.0-rc.11",
+                "X-Fern-SDK-Version": "2.0.0-rc.13",
+                "User-Agent": "rcs-js/2.0.0-rc.13",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/esm/api/resources/campaigns/resources/rcs/client/Client.d.mts

@@ -71,6 +71,7 @@ export declare class Rcs {
      *
      * @throws {@link Pinnacle.BadRequestError}
      * @throws {@link Pinnacle.UnauthorizedError}
+     * @throws {@link Pinnacle.PaymentRequiredError}
      * @throws {@link Pinnacle.NotFoundError}
      * @throws {@link Pinnacle.InternalServerError}
      *

package/dist/esm/api/resources/campaigns/resources/rcs/client/Client.mjs

@@ -169,6 +169,7 @@ export class Rcs {
      *
      * @throws {@link Pinnacle.BadRequestError}
      * @throws {@link Pinnacle.UnauthorizedError}
+     * @throws {@link Pinnacle.PaymentRequiredError}
      * @throws {@link Pinnacle.NotFoundError}
      * @throws {@link Pinnacle.InternalServerError}
      *
@@ -200,6 +201,8 @@ export class Rcs {
                         throw new Pinnacle.BadRequestError(_response.error.body, _response.rawResponse);
                     case 401:
                         throw new Pinnacle.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 402:
+                        throw new Pinnacle.PaymentRequiredError(_response.error.body, _response.rawResponse);
                     case 404:
                         throw new Pinnacle.NotFoundError(_response.error.body, _response.rawResponse);
                     case 500:

package/dist/esm/api/resources/messages/resources/rcs/client/Client.d.mts

@@ -34,7 +34,7 @@ export declare class Rcs {
      *
      * Requires an active RCS agent and recipient devices that support RCS Business Messaging.
      *
-     * @param {Pinnacle.Rcs} request
+     * @param {Pinnacle.RichMessage} request
      * @param {Rcs.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Pinnacle.BadRequestError}
@@ -56,7 +56,7 @@ export declare class Rcs {
      *         to: "to"
      *     })
      */
-    send(request: Pinnacle.Rcs, requestOptions?: Rcs.RequestOptions): core.HttpResponsePromise<Pinnacle.messages.RcsSendResponse>;
+    send(request: Pinnacle.RichMessage, requestOptions?: Rcs.RequestOptions): core.HttpResponsePromise<Pinnacle.messages.RcsSendResponse>;
     private __send;
     /**
      * Validate RCS message content without sending it.

package/dist/esm/api/resources/messages/resources/rcs/client/Client.mjs

@@ -24,7 +24,7 @@ export class Rcs {
      *
      * Requires an active RCS agent and recipient devices that support RCS Business Messaging.
      *
-     * @param {Pinnacle.Rcs} request
+     * @param {Pinnacle.RichMessage} request
      * @param {Rcs.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link Pinnacle.BadRequestError}

package/dist/esm/api/resources/tools/resources/file/client/Client.d.mts

@@ -53,6 +53,27 @@ export declare class File_ {
      */
     upload(request: Pinnacle.tools.UploadFileParams, requestOptions?: File_.RequestOptions): core.HttpResponsePromise<Pinnacle.UploadResults>;
     private __upload;
+    /**
+     * Refresh expiring presigned URLs for Pinnacle-hosted files to extend their access time.
+     *
+     * <Callout type="info">
+     *   This only works for presigned download URLs. At this moment, you cannot refresh a presigned upload URL, generate a new one instead.
+     * </Callout>
+     *
+     * @param {Pinnacle.tools.RefreshFileParams} request
+     * @param {File_.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Pinnacle.BadRequestError}
+     * @throws {@link Pinnacle.UnauthorizedError}
+     * @throws {@link Pinnacle.InternalServerError}
+     *
+     * @example
+     *     await client.tools.file.refresh({
+     *         uris: ["https://server.trypinnacle.app/storage/v1/object/sign/vault/3/test.jpg?token=oldtoken", "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/document.pdf?token=oldtoken2", "icons/3/test.jpg", "invalid/url", "https://google.com"]
+     *     })
+     */
+    refresh(request: Pinnacle.tools.RefreshFileParams, requestOptions?: File_.RequestOptions): core.HttpResponsePromise<Pinnacle.RefreshedFile[]>;
+    private __refresh;
     protected _getCustomAuthorizationHeaders(): Promise<{
         "PINNACLE-API-KEY": string;
     }>;

package/dist/esm/api/resources/tools/resources/file/client/Client.mjs

@@ -96,6 +96,80 @@ export class File_ {
             }
         });
     }
+    /**
+     * Refresh expiring presigned URLs for Pinnacle-hosted files to extend their access time.
+     *
+     * <Callout type="info">
+     *   This only works for presigned download URLs. At this moment, you cannot refresh a presigned upload URL, generate a new one instead.
+     * </Callout>
+     *
+     * @param {Pinnacle.tools.RefreshFileParams} request
+     * @param {File_.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Pinnacle.BadRequestError}
+     * @throws {@link Pinnacle.UnauthorizedError}
+     * @throws {@link Pinnacle.InternalServerError}
+     *
+     * @example
+     *     await client.tools.file.refresh({
+     *         uris: ["https://server.trypinnacle.app/storage/v1/object/sign/vault/3/test.jpg?token=oldtoken", "https://server.trypinnacle.app/storage/v1/object/sign/vault/3/document.pdf?token=oldtoken2", "icons/3/test.jpg", "invalid/url", "https://google.com"]
+     *     })
+     */
+    refresh(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__refresh(request, requestOptions));
+    }
+    __refresh(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            let _headers = mergeHeaders((_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders(Object.assign({}, (yield this._getCustomAuthorizationHeaders()))), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield core.fetcher({
+                url: core.url.join((_c = (_b = (yield core.Supplier.get(this._options.baseUrl))) !== null && _b !== void 0 ? _b : (yield core.Supplier.get(this._options.environment))) !== null && _c !== void 0 ? _c : environments.PinnacleEnvironment.Default, "tools/files/refresh"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: (requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) != null ? requestOptions.timeoutInSeconds * 1000 : 60000,
+                maxRetries: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+            });
+            if (_response.ok) {
+                return { data: _response.body, rawResponse: _response.rawResponse };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new Pinnacle.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new Pinnacle.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new Pinnacle.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.PinnacleError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.PinnacleError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.PinnacleTimeoutError("Timeout exceeded when calling POST /tools/files/refresh.");
+                case "unknown":
+                    throw new errors.PinnacleError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     _getCustomAuthorizationHeaders() {
         return __awaiter(this, void 0, void 0, function* () {
             const apiKeyValue = yield core.Supplier.get(this._options.apiKey);