@pnp/sp 4.0.0-alpha0-v4nightly.20240108 → 4.0.0-alpha0-v4nightly.20240110

package/commonjs/folders/index.d.ts

@@ -0,0 +1,5 @@
+import "./item.js";
+import "./list.js";
+import "./web.js";
+export { Folder, IFolderAddResult, IFolderUpdateResult, Folders, IFolder, IFolders, IFolderInfo, IFolderDeleteParams, IFolderParentInfos, folderFromServerRelativePath, folderFromAbsolutePath, folderFromPath, IStorageMetrics, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/commonjs/folders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/sp/folders/index.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,CAAC;AACnB,OAAO,WAAW,CAAC;AACnB,OAAO,UAAU,CAAC;AAElB,OAAO,EACH,MAAM,EACN,gBAAgB,EAChB,mBAAmB,EACnB,OAAO,EACP,OAAO,EACP,QAAQ,EACR,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,sBAAsB,EACtB,cAAc,EACd,eAAe,GAClB,MAAM,YAAY,CAAC"}

package/commonjs/folders/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.folderFromPath = exports.folderFromAbsolutePath = exports.folderFromServerRelativePath = exports.Folders = exports.Folder = void 0;
+require("./item.js");
+require("./list.js");
+require("./web.js");
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "Folder", { enumerable: true, get: function () { return types_js_1.Folder; } });
+Object.defineProperty(exports, "Folders", { enumerable: true, get: function () { return types_js_1.Folders; } });
+Object.defineProperty(exports, "folderFromServerRelativePath", { enumerable: true, get: function () { return types_js_1.folderFromServerRelativePath; } });
+Object.defineProperty(exports, "folderFromAbsolutePath", { enumerable: true, get: function () { return types_js_1.folderFromAbsolutePath; } });
+Object.defineProperty(exports, "folderFromPath", { enumerable: true, get: function () { return types_js_1.folderFromPath; } });
+//# sourceMappingURL=index.js.map

package/commonjs/folders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/sp/folders/index.ts"],"names":[],"mappings":";;;AAAA,qBAAmB;AACnB,qBAAmB;AACnB,oBAAkB;AAElB,uCAcoB;AAbhB,kGAAA,MAAM,OAAA;AAGN,mGAAA,OAAO,OAAA;AAMP,wHAAA,4BAA4B,OAAA;AAC5B,kHAAA,sBAAsB,OAAA;AACtB,0GAAA,cAAc,OAAA"}

package/commonjs/folders/item.d.ts

@@ -0,0 +1,10 @@
+import { IFolder } from "./types.js";
+declare module "../items/types" {
+    interface _Item {
+        readonly folder: IFolder;
+    }
+    interface IItem {
+        readonly folder: IFolder;
+    }
+}
+//# sourceMappingURL=item.d.ts.map

package/commonjs/folders/item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../../../../../packages/sp/folders/item.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,OAAO,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,QAAQ,gBAAgB,CAAC;IAC5B,UAAU,KAAK;QACX,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;KAE5B;IACD,UAAU,KAAK;QACX,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;KAE5B;CACJ"}

package/commonjs/folders/item.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const queryable_1 = require("@pnp/queryable");
+const types_js_1 = require("../items/types.js");
+const types_js_2 = require("./types.js");
+(0, queryable_1.addProp)(types_js_1._Item, "folder", types_js_2.Folder);
+//# sourceMappingURL=item.js.map

package/commonjs/folders/item.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"item.js","sourceRoot":"","sources":["../../../../../packages/sp/folders/item.ts"],"names":[],"mappings":";;AAAA,8CAAyC;AACzC,gDAA0C;AAC1C,yCAA6C;AAa7C,IAAA,mBAAO,EAAC,gBAAK,EAAE,QAAQ,EAAE,iBAAM,CAAC,CAAC"}

package/commonjs/folders/list.d.ts

@@ -0,0 +1,13 @@
+import { IFolder } from "./types.js";
+declare module "../lists/types" {
+    interface _List {
+        readonly rootFolder: IFolder;
+    }
+    interface IList {
+        /**
+         * Root folder for this list/library
+         */
+        readonly rootFolder: IFolder;
+    }
+}
+//# sourceMappingURL=list.d.ts.map

package/commonjs/folders/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../../packages/sp/folders/list.ts"],"names":[],"mappings":"AAEA,OAAO,EAAU,OAAO,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,QAAQ,gBAAgB,CAAC;IAC5B,UAAU,KAAK;QACX,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;KAChC;IACD,UAAU,KAAK;QACX;;WAEG;QACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;KAChC;CACJ"}

package/commonjs/folders/list.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const queryable_1 = require("@pnp/queryable");
+const types_js_1 = require("../lists/types.js");
+const types_js_2 = require("./types.js");
+(0, queryable_1.addProp)(types_js_1._List, "rootFolder", types_js_2.Folder);
+//# sourceMappingURL=list.js.map

package/commonjs/folders/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../../packages/sp/folders/list.ts"],"names":[],"mappings":";;AAAA,8CAAyC;AACzC,gDAA0C;AAC1C,yCAA6C;AAc7C,IAAA,mBAAO,EAAC,gBAAK,EAAE,YAAY,EAAE,iBAAM,CAAC,CAAC"}

package/commonjs/folders/types.d.ts

@@ -0,0 +1,237 @@
+import { _SPCollection, _SPInstance, ISPInstance, IDeleteableWithETag, ISPQueryable } from "../spqueryable.js";
+import { IItem } from "../items/types.js";
+import { IResourcePath } from "../utils/to-resource-path.js";
+import "../context-info/index.js";
+import { IMoveCopyOptions } from "../types.js";
+export declare class _Folders extends _SPCollection<IFolderInfo[]> {
+    /**
+     * Gets a folder by it's name
+     *
+     * @param name Folder's name
+     */
+    getByUrl(name: string): IFolder;
+    /**
+     * Adds a new folder by path and should be prefered over add
+     *
+     * @param serverRelativeUrl The server relative url of the new folder to create
+     * @param overwrite True to overwrite an existing folder, default false
+     */
+    addUsingPath(serverRelativeUrl: string, overwrite?: boolean): Promise<IFolderAddResult>;
+}
+export interface IFolders extends _Folders {
+}
+export declare const Folders: import("../spqueryable.js").ISPInvokableFactory<IFolders>;
+export declare class _Folder extends _SPInstance<IFolderInfo> {
+    delete: (this: ISPQueryable<any>, eTag?: string) => Promise<void>;
+    /**
+     * Gets this folder's sub folders
+     *
+     */
+    get folders(): IFolders;
+    /**
+     * Gets this folder's list item field values
+     *
+     */
+    get listItemAllFields(): ISPInstance;
+    /**
+     * Gets the parent folder, if available
+     *
+     */
+    get parentFolder(): IFolder;
+    /**
+     * Gets this folder's properties
+     *
+     */
+    get properties(): ISPInstance;
+    /**
+     * Gets this folder's storage metrics information
+     *
+     */
+    get storageMetrics(): ISPInstance<IStorageMetrics>;
+    /**
+     * Updates folder's properties
+     * @param props Folder's properties to update
+     */
+    update(props: Partial<IFolderInfo>): Promise<IFolderUpdateResult>;
+    /**
+     * Moves the folder to the Recycle Bin and returns the identifier of the new Recycle Bin item.
+     */
+    recycle(): Promise<string>;
+    /**
+     * Gets the associated list item for this folder, loading the default properties
+     */
+    getItem<T>(...selects: string[]): Promise<IItem & T>;
+    /**
+     * Moves the file by path to the specified destination url.
+     * Also works with different site collections.
+     *
+     * @param destUrl The absolute url or server relative url of the destination file path to move to.
+     * @param shouldOverWrite Should a file with the same name in the same location be overwritten?
+     * @param options Allows you to supply the full set of options controlling the move behavior
+     */
+    moveByPath(destUrl: string, options: Partial<Omit<IMoveCopyOptions, "ResetAuthorAndCreatedOnCopy">>): Promise<IFolder>;
+    /**
+     * Moves the file by path to the specified destination url.
+     * Also works with different site collections.
+     *
+     * @param destUrl The absolute url or server relative url of the destination file path to move to.
+     * @param keepBoth Keep both if file with the same name in the same location already exists? Only relevant when shouldOverWrite is set to false.
+     */
+    moveByPath(destUrl: string, KeepBoth?: boolean): Promise<IFolder>;
+    /**
+     * Moves the folder by path to the specified destination url.
+     * Also works with different site collections.
+     *
+     * @param destUrl The absolute url or server relative url of the destination folder path to move to.
+     * @param shouldOverWrite Should a folder with the same name in the same location be overwritten?
+     * @param options Allows you to supply the full set of options controlling the copy behavior
+     */
+    copyByPath(destUrl: string, options: Partial<Omit<IMoveCopyOptions, "RetainEditorAndModifiedOnMove">>): Promise<IFolder>;
+    /**
+     * Copies a folder by path to destination path
+     * Also works with different site collections.
+     *
+     * @param destUrl Absolute or relative URL of the destination path
+     * @param keepBoth Keep both if folder with the same name in the same location already exists?
+     */
+    copyByPath(destUrl: string, KeepBoth?: boolean): Promise<IFolder>;
+    /**
+     * Deletes the folder object with options.
+     *
+     * @param parameters Specifies the options to use when deleting a folder.
+     */
+    deleteWithParams(parameters: Partial<IFolderDeleteParams>): Promise<void>;
+    /**
+     * Create the subfolder inside the current folder, as specified by the leafPath
+     *
+     * @param leafPath leafName of the new folder
+     */
+    addSubFolderUsingPath(leafPath: string): Promise<IFolder>;
+    /**
+     * Gets the parent information for this folder's list and web
+     */
+    getParentInfos(): Promise<IFolderParentInfos>;
+    /**
+     * Implementation of folder move/copy
+     *
+     * @param destUrl The server relative path to which the folder will be copied/moved
+     * @param options Any options
+     * @param methodName The method to call
+     * @returns An IFolder representing the moved or copied folder
+     */
+    protected moveCopyImpl(destUrl: string, options: Partial<IMoveCopyOptions>, methodName: "MoveFolderByPath" | "CopyFolderByPath"): Promise<IFolder>;
+}
+export interface IFolder extends _Folder, IDeleteableWithETag {
+}
+export declare const Folder: import("../spqueryable.js").ISPInvokableFactory<IFolder>;
+/**
+ * Creates an IFolder instance given a base object and a server relative path
+ *
+ * @param base Valid SPQueryable from which the observers will be used and the web url extracted
+ * @param serverRelativePath The server relative url to the folder (ex: '/sites/dev/documents/folder3')
+ * @returns IFolder instance referencing the folder described by the supplied parameters
+ */
+export declare function folderFromServerRelativePath(base: ISPQueryable, serverRelativePath: string): IFolder;
+/**
+ * Creates an IFolder instance given a base object and an absolute path
+ *
+ * @param base Valid SPQueryable from which the observers will be used
+ * @param serverRelativePath The absolute url to the folder (ex: 'https://tenant.sharepoint.com/sites/dev/documents/folder/')
+ * @returns IFolder instance referencing the folder described by the supplied parameters
+ */
+export declare function folderFromAbsolutePath(base: ISPQueryable, absoluteFolderPath: string): Promise<IFolder>;
+/**
+ * Creates an IFolder intance given a base object and either an absolute or server relative path to a folder
+ *
+ * @param base Valid SPQueryable from which the observers will be used
+ * @param serverRelativePath server relative or absolute url to the file (ex: 'https://tenant.sharepoint.com/sites/dev/documents/folder' or '/sites/dev/documents/folder')
+ * @returns IFile instance referencing the file described by the supplied parameters
+ */
+export declare function folderFromPath(base: ISPQueryable, path: string): Promise<IFolder>;
+/**
+ * Describes result of adding a folder
+ */
+export interface IFolderAddResult {
+    /**
+     * A folder's instance
+     */
+    folder: IFolder;
+    /**
+     * Additional data from the server
+     */
+    data: any;
+}
+/**
+ * Describes result of updating a folder
+ */
+export interface IFolderUpdateResult {
+    /**
+     * A folder's instance
+     */
+    folder: IFolder;
+    /**
+     * Additional data from the server
+     */
+    data: any;
+}
+export interface IFolderInfo {
+    readonly "odata.id": string;
+    Exists: boolean;
+    IsWOPIEnabled: boolean;
+    ItemCount: number;
+    Name: string;
+    ProgID: string | null;
+    ServerRelativeUrl: string;
+    ServerRelativePath: IResourcePath;
+    TimeCreated: string;
+    TimeLastModified: string;
+    UniqueId: string;
+    WelcomePage: string;
+    ContentTypeOrder: string[];
+    UniqueContentTypeOrder: string[];
+    StorageMetrics?: IStorageMetrics;
+}
+export interface IStorageMetrics {
+    LastModified: string;
+    TotalFileCount: number;
+    TotalFileStreamSize: number;
+    TotalSize: number;
+}
+export interface IFolderDeleteParams {
+    /**
+     * If true, delete or recycle a folder iff all files have
+     * LockType values SPLockType.Shared or SPLockType.None.
+     * When false, delete or recycle the folder if all files
+     * have  the LockType value SPLockType.None. See the <see cref="SPFile.SPLockType"/> enum.
+     */
+    BypassSharedLock: boolean;
+    /**
+     * Gets or sets a string value that allows SPFolder delete
+     * and recycle methods to target a folder with a matching value
+     */
+    ETagMatch: string;
+    /**
+     * Gets or sets a Boolean that controls the way in which folders
+     * are deleted. If set to true, only empty folders will be deleted.
+     * If set to false, folders that are not empty may be deleted.
+     */
+    DeleteIfEmpty: boolean;
+}
+export interface IFolderParentInfos {
+    Folder: {
+        ServerRelativeUrl: string;
+    };
+    ParentList: {
+        Id: string;
+        RootFolderServerRelativePath: IResourcePath;
+        RootFolderServerRelativeUrl: string;
+        RootFolderUniqueId: string;
+    };
+    ParentWeb: {
+        Id: string;
+        ServerRelativePath: IResourcePath;
+        ServerRelativeUrl: string;
+        Url: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/commonjs/folders/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../packages/sp/folders/types.ts"],"names":[],"mappings":"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"}

package/commonjs/folders/types.js

@@ -0,0 +1,253 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.folderFromPath = exports.folderFromAbsolutePath = exports.folderFromServerRelativePath = exports.Folder = exports._Folder = exports.Folders = exports._Folders = void 0;
+const tslib_1 = require("tslib");
+const core_1 = require("@pnp/core");
+const queryable_1 = require("@pnp/queryable");
+const spqueryable_js_1 = require("../spqueryable.js");
+const odata_url_from_js_1 = require("../utils/odata-url-from.js");
+const types_js_1 = require("../items/types.js");
+const decorators_js_1 = require("../decorators.js");
+const extract_web_url_js_1 = require("../utils/extract-web-url.js");
+const to_resource_path_js_1 = require("../utils/to-resource-path.js");
+const encode_path_str_js_1 = require("../utils/encode-path-str.js");
+require("../context-info/index.js");
+const batching_js_1 = require("../batching.js");
+let _Folders = class _Folders extends spqueryable_js_1._SPCollection {
+    /**
+     * Gets a folder by it's name
+     *
+     * @param name Folder's name
+     */
+    getByUrl(name) {
+        return (0, exports.Folder)(this).concat(`('${(0, encode_path_str_js_1.encodePath)(name)}')`);
+    }
+    /**
+     * Adds a new folder by path and should be prefered over add
+     *
+     * @param serverRelativeUrl The server relative url of the new folder to create
+     * @param overwrite True to overwrite an existing folder, default false
+     */
+    async addUsingPath(serverRelativeUrl, overwrite = false) {
+        const data = await (0, spqueryable_js_1.spPost)((0, exports.Folders)(this, `addUsingPath(DecodedUrl='${(0, encode_path_str_js_1.encodePath)(serverRelativeUrl)}',overwrite=${overwrite})`));
+        return {
+            data,
+            folder: folderFromServerRelativePath(this, data.ServerRelativeUrl),
+        };
+    }
+};
+_Folders = (0, tslib_1.__decorate)([
+    (0, decorators_js_1.defaultPath)("folders")
+], _Folders);
+exports._Folders = _Folders;
+exports.Folders = (0, spqueryable_js_1.spInvokableFactory)(_Folders);
+class _Folder extends spqueryable_js_1._SPInstance {
+    constructor() {
+        super(...arguments);
+        this.delete = (0, spqueryable_js_1.deleteableWithETag)();
+    }
+    /**
+     * Gets this folder's sub folders
+     *
+     */
+    get folders() {
+        return (0, exports.Folders)(this);
+    }
+    /**
+     * Gets this folder's list item field values
+     *
+     */
+    get listItemAllFields() {
+        return (0, spqueryable_js_1.SPInstance)(this, "listItemAllFields");
+    }
+    /**
+     * Gets the parent folder, if available
+     *
+     */
+    get parentFolder() {
+        return (0, exports.Folder)(this, "parentFolder");
+    }
+    /**
+     * Gets this folder's properties
+     *
+     */
+    get properties() {
+        return (0, spqueryable_js_1.SPInstance)(this, "properties");
+    }
+    /**
+     * Gets this folder's storage metrics information
+     *
+     */
+    get storageMetrics() {
+        return (0, spqueryable_js_1.SPInstance)(this, "storagemetrics");
+    }
+    /**
+     * Updates folder's properties
+     * @param props Folder's properties to update
+     */
+    async update(props) {
+        const data = await (0, spqueryable_js_1.spPostMerge)(this, (0, queryable_1.body)(props));
+        return {
+            data,
+            folder: this,
+        };
+    }
+    /**
+     * Moves the folder to the Recycle Bin and returns the identifier of the new Recycle Bin item.
+     */
+    recycle() {
+        return (0, spqueryable_js_1.spPost)((0, exports.Folder)(this, "recycle"));
+    }
+    /**
+     * Gets the associated list item for this folder, loading the default properties
+     */
+    async getItem(...selects) {
+        const q = this.listItemAllFields;
+        const d = await q.select(...selects)();
+        if (d["odata.null"]) {
+            throw Error("No associated item was found for this folder. It may be the root folder, which does not have an item.");
+        }
+        return Object.assign((0, types_js_1.Item)([this, (0, odata_url_from_js_1.odataUrlFrom)(d)]), d);
+    }
+    async moveByPath(destUrl, ...rest) {
+        let options = {
+            KeepBoth: false,
+            ShouldBypassSharedLocks: true,
+            RetainEditorAndModifiedOnMove: false,
+        };
+        if (rest.length === 1) {
+            if (typeof rest[0] === "boolean") {
+                options.KeepBoth = rest[0];
+            }
+            else if (typeof rest[0] === "object") {
+                options = { ...options, ...rest[0] };
+            }
+        }
+        return this.moveCopyImpl(destUrl, options, "MoveFolderByPath");
+    }
+    async copyByPath(destUrl, ...rest) {
+        let options = {
+            ShouldBypassSharedLocks: true,
+            ResetAuthorAndCreatedOnCopy: true,
+            KeepBoth: false,
+        };
+        if (rest.length === 1) {
+            if (typeof rest[0] === "boolean") {
+                options.KeepBoth = rest[0];
+            }
+            else if (typeof rest[0] === "object") {
+                options = { ...options, ...rest[0] };
+            }
+        }
+        return this.moveCopyImpl(destUrl, options, "CopyFolderByPath");
+    }
+    /**
+     * Deletes the folder object with options.
+     *
+     * @param parameters Specifies the options to use when deleting a folder.
+     */
+    async deleteWithParams(parameters) {
+        return (0, spqueryable_js_1.spPost)((0, exports.Folder)(this, "DeleteWithParameters"), (0, queryable_1.body)({ parameters }));
+    }
+    /**
+     * Create the subfolder inside the current folder, as specified by the leafPath
+     *
+     * @param leafPath leafName of the new folder
+     */
+    async addSubFolderUsingPath(leafPath) {
+        await (0, spqueryable_js_1.spPost)((0, exports.Folder)(this, "AddSubFolderUsingPath"), (0, queryable_1.body)({ leafPath: (0, to_resource_path_js_1.toResourcePath)(leafPath) }));
+        return this.folders.getByUrl(leafPath);
+    }
+    /**
+     * Gets the parent information for this folder's list and web
+     */
+    async getParentInfos() {
+        const urlInfo = await this.select("ServerRelativeUrl", "ListItemAllFields/ParentList/Id", "ListItemAllFields/ParentList/RootFolder/UniqueId", "ListItemAllFields/ParentList/RootFolder/ServerRelativeUrl", "ListItemAllFields/ParentList/RootFolder/ServerRelativePath", "ListItemAllFields/ParentList/ParentWeb/Id", "ListItemAllFields/ParentList/ParentWeb/Url", "ListItemAllFields/ParentList/ParentWeb/ServerRelativeUrl", "ListItemAllFields/ParentList/ParentWeb/ServerRelativePath").expand("ListItemAllFields/ParentList", "ListItemAllFields/ParentList/RootFolder", "ListItemAllFields/ParentList/ParentWeb")();
+        return {
+            Folder: {
+                ServerRelativeUrl: urlInfo.ServerRelativeUrl,
+            },
+            ParentList: {
+                Id: urlInfo.ListItemAllFields.ParentList.Id,
+                RootFolderServerRelativePath: urlInfo.ListItemAllFields.ParentList.RootFolder.ServerRelativePath,
+                RootFolderServerRelativeUrl: urlInfo.ListItemAllFields.ParentList.RootFolder.ServerRelativeUrl,
+                RootFolderUniqueId: urlInfo.ListItemAllFields.ParentList.RootFolder.UniqueId,
+            },
+            ParentWeb: {
+                Id: urlInfo.ListItemAllFields.ParentList.ParentWeb.Id,
+                ServerRelativePath: urlInfo.ListItemAllFields.ParentList.ParentWeb.ServerRelativePath,
+                ServerRelativeUrl: urlInfo.ListItemAllFields.ParentList.ParentWeb.ServerRelativeUrl,
+                Url: urlInfo.ListItemAllFields.ParentList.ParentWeb.Url,
+            },
+        };
+    }
+    /**
+     * Implementation of folder move/copy
+     *
+     * @param destUrl The server relative path to which the folder will be copied/moved
+     * @param options Any options
+     * @param methodName The method to call
+     * @returns An IFolder representing the moved or copied folder
+     */
+    moveCopyImpl(destUrl, options, methodName) {
+        // create a timeline we will manipulate for this request
+        const poster = (0, exports.Folder)(this);
+        // add our pre-request actions, this fixes issues with batching hanging #2668
+        poster.on.pre((0, core_1.noInherit)(async (url, init, result) => {
+            const urlInfo = await (0, exports.Folder)(this).using((0, batching_js_1.BatchNever)()).getParentInfos();
+            const uri = new URL(urlInfo.ParentWeb.Url);
+            url = (0, core_1.combine)(urlInfo.ParentWeb.Url, `/_api/SP.MoveCopyUtil.${methodName}()`);
+            init = (0, queryable_1.body)({
+                destPath: (0, to_resource_path_js_1.toResourcePath)((0, core_1.isUrlAbsolute)(destUrl) ? destUrl : (0, core_1.combine)(uri.origin, destUrl)),
+                options,
+                srcPath: (0, to_resource_path_js_1.toResourcePath)((0, core_1.combine)(uri.origin, urlInfo.Folder.ServerRelativeUrl)),
+            }, init);
+            return [url, init, result];
+        }));
+        return (0, spqueryable_js_1.spPost)(poster).then(() => folderFromPath(this, destUrl));
+    }
+}
+(0, tslib_1.__decorate)([
+    queryable_1.cancelableScope
+], _Folder.prototype, "moveByPath", null);
+(0, tslib_1.__decorate)([
+    queryable_1.cancelableScope
+], _Folder.prototype, "copyByPath", null);
+exports._Folder = _Folder;
+exports.Folder = (0, spqueryable_js_1.spInvokableFactory)(_Folder);
+/**
+ * Creates an IFolder instance given a base object and a server relative path
+ *
+ * @param base Valid SPQueryable from which the observers will be used and the web url extracted
+ * @param serverRelativePath The server relative url to the folder (ex: '/sites/dev/documents/folder3')
+ * @returns IFolder instance referencing the folder described by the supplied parameters
+ */
+function folderFromServerRelativePath(base, serverRelativePath) {
+    return (0, exports.Folder)([base, (0, extract_web_url_js_1.extractWebUrl)(base.toUrl())], `_api/web/getFolderByServerRelativePath(decodedUrl='${(0, encode_path_str_js_1.encodePath)(serverRelativePath)}')`);
+}
+exports.folderFromServerRelativePath = folderFromServerRelativePath;
+/**
+ * Creates an IFolder instance given a base object and an absolute path
+ *
+ * @param base Valid SPQueryable from which the observers will be used
+ * @param serverRelativePath The absolute url to the folder (ex: 'https://tenant.sharepoint.com/sites/dev/documents/folder/')
+ * @returns IFolder instance referencing the folder described by the supplied parameters
+ */
+async function folderFromAbsolutePath(base, absoluteFolderPath) {
+    const { WebFullUrl } = await (0, exports.Folder)(this).using((0, batching_js_1.BatchNever)()).getContextInfo(absoluteFolderPath);
+    const { pathname } = new URL(absoluteFolderPath);
+    return folderFromServerRelativePath((0, exports.Folder)([base, (0, core_1.combine)(WebFullUrl, "_api/web")]), decodeURIComponent(pathname));
+}
+exports.folderFromAbsolutePath = folderFromAbsolutePath;
+/**
+ * Creates an IFolder intance given a base object and either an absolute or server relative path to a folder
+ *
+ * @param base Valid SPQueryable from which the observers will be used
+ * @param serverRelativePath server relative or absolute url to the file (ex: 'https://tenant.sharepoint.com/sites/dev/documents/folder' or '/sites/dev/documents/folder')
+ * @returns IFile instance referencing the file described by the supplied parameters
+ */
+async function folderFromPath(base, path) {
+    return ((0, core_1.isUrlAbsolute)(path) ? folderFromAbsolutePath : folderFromServerRelativePath)(base, path);
+}
+exports.folderFromPath = folderFromPath;
+//# sourceMappingURL=types.js.map

package/commonjs/folders/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../packages/sp/folders/types.ts"],"names":[],"mappings":"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"}

package/commonjs/folders/web.d.ts

@@ -0,0 +1,33 @@
+import { IFolders, IFolder } from "./types.js";
+declare module "../webs/types" {
+    interface _Web {
+        readonly folders: IFolders;
+        readonly rootFolder: IFolder;
+        getFolderByServerRelativePath(folderRelativeUrl: string): IFolder;
+        getFolderById(uniqueId: string): IFolder;
+    }
+    interface IWeb {
+        /**
+         * Gets the collection of folders in this web
+         */
+        readonly folders: IFolders;
+        /**
+         * Gets the root folder of the web
+         */
+        readonly rootFolder: IFolder;
+        /**
+         * Gets a folder by server relative path if your folder name contains # and % characters
+         * This works only in SharePoint online.
+         *
+         * @param folderRelativeUrl The server relative path to the folder (including /sites/ if applicable)
+         */
+        getFolderByServerRelativePath(folderRelativeUrl: string): IFolder;
+        /**
+         * Gets a folder by id
+         *
+         * @param uniqueId The UniqueId of the folder
+         */
+        getFolderById(uniqueId: string): IFolder;
+    }
+}
+//# sourceMappingURL=web.d.ts.map

package/commonjs/folders/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../../../packages/sp/folders/web.ts"],"names":[],"mappings":"AAEA,OAAO,EAAW,QAAQ,EAAU,OAAO,EAAgC,MAAM,YAAY,CAAC;AAE9F,OAAO,QAAQ,eAAe,CAAC;IAC3B,UAAU,IAAI;QACV,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;QAC7B,6BAA6B,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC;QAClE,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;KAC5C;IACD,UAAU,IAAI;QAEV;;WAEG;QACH,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;QAE3B;;WAEG;QACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;QAE7B;;;;;WAKG;QACH,6BAA6B,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC;QAElE;;;;WAIG;QACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;KAC5C;CACJ"}

package/commonjs/folders/web.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const queryable_1 = require("@pnp/queryable");
+const types_js_1 = require("../webs/types.js");
+const types_js_2 = require("./types.js");
+(0, queryable_1.addProp)(types_js_1._Web, "folders", types_js_2.Folders);
+(0, queryable_1.addProp)(types_js_1._Web, "rootFolder", types_js_2.Folder);
+types_js_1._Web.prototype.getFolderByServerRelativePath = function (folderRelativeUrl) {
+    return (0, types_js_2.folderFromServerRelativePath)(this, folderRelativeUrl);
+};
+types_js_1._Web.prototype.getFolderById = function (uniqueId) {
+    return (0, types_js_2.Folder)(this, `getFolderById('${uniqueId}')`);
+};
+//# sourceMappingURL=web.js.map

package/commonjs/folders/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../../../packages/sp/folders/web.ts"],"names":[],"mappings":";;AAAA,8CAAyC;AACzC,+CAAwC;AACxC,yCAA8F;AAsC9F,IAAA,mBAAO,EAAC,eAAI,EAAE,SAAS,EAAE,kBAAO,CAAC,CAAC;AAClC,IAAA,mBAAO,EAAC,eAAI,EAAE,YAAY,EAAE,iBAAM,CAAC,CAAC;AAEpC,eAAI,CAAC,SAAS,CAAC,6BAA6B,GAAG,UAAsB,iBAAyB;IAC1F,OAAO,IAAA,uCAA4B,EAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;AACjE,CAAC,CAAC;AAEF,eAAI,CAAC,SAAS,CAAC,aAAa,GAAG,UAAsB,QAAgB;IACjE,OAAO,IAAA,iBAAM,EAAC,IAAI,EAAE,kBAAkB,QAAQ,IAAI,CAAC,CAAC;AACxD,CAAC,CAAC"}