@pnp/sp 4.9.0-v4nightly.20250204 → 4.9.0-v4nightly.20250206

package/index.d.ts

@@ -2,6 +2,7 @@ export * from "./spqueryable.js";
 export * from "./decorators.js";
 export { SPFI, spfi, } from "./fi.js";
 export * from "./types.js";
+export * from "./utils/create-change-token.js";
 export * from "./utils/extract-web-url.js";
 export * from "./utils/file-names.js";
 export * from "./utils/odata-url-from.js";

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/sp/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AAEjC,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EACH,IAAI,EACJ,IAAI,GACP,MAAM,SAAS,CAAC;AAEjB,cAAc,YAAY,CAAC;AAE3B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAE3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/sp/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AAEjC,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EACH,IAAI,EACJ,IAAI,GACP,MAAM,SAAS,CAAC;AAEjB,cAAc,YAAY,CAAC;AAE3B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAE3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}

package/index.js

@@ -2,6 +2,7 @@ export * from "./spqueryable.js";
 export * from "./decorators.js";
 export { SPFI, spfi, } from "./fi.js";
 export * from "./types.js";
+export * from "./utils/create-change-token.js";
 export * from "./utils/extract-web-url.js";
 export * from "./utils/file-names.js";
 export * from "./utils/odata-url-from.js";

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/sp/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AAEjC,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EACH,IAAI,EACJ,IAAI,GACP,MAAM,SAAS,CAAC;AAEjB,cAAc,YAAY,CAAC;AAE3B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAE3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../packages/sp/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AAEjC,cAAc,iBAAiB,CAAC;AAEhC,OAAO,EACH,IAAI,EACJ,IAAI,GACP,MAAM,SAAS,CAAC;AAEjB,cAAc,YAAY,CAAC;AAE3B,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAE3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC"}

package/package.json

@@ -1,13 +1,13 @@
 {
     "name": "@pnp/sp",
-    "version": "4.9.0-v4nightly.20250204",
+    "version": "4.9.0-v4nightly.20250206",
     "description": "pnp - provides a fluent api for working with SharePoint REST",
     "main": "./index.js",
     "typings": "./index",
     "dependencies": {
         "tslib": "2.7.0",
-        "@pnp/core": "4.9.0-v4nightly.20250204",
-        "@pnp/queryable": "4.9.0-v4nightly.20250204"
+        "@pnp/core": "4.9.0-v4nightly.20250206",
+        "@pnp/queryable": "4.9.0-v4nightly.20250206"
     },
     "type": "module",
     "engines": {

package/utils/create-change-token.d.ts

@@ -0,0 +1,12 @@
+import { IChangeToken } from "../types.js";
+/**
+ * Creates a change token for use with sites, webs, or lists
+ *
+ * @param resourceType The type of resource for which you want a change token
+ * @param resource The identifier (GUID) of the resource site.Id, web.Id, or List.Id
+ * @param tokenDate The date for this token (if start token, start date of chages; if end token, end date of the changes)
+ * @param versionNumber Version number for token (default = 1)
+ * @returns A properly formatted change token
+ */
+export declare function createChangeToken(resourceType: "site" | "web" | "list", resource: string, tokenDate?: Date, versionNumber?: number): IChangeToken;
+//# sourceMappingURL=create-change-token.d.ts.map

package/utils/create-change-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-change-token.d.ts","sourceRoot":"","sources":["../../../../packages/sp/utils/create-change-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,KAAK,GAAG,MAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAE,IAAiB,EAAE,aAAa,SAAI,GAAG,YAAY,CAYjK"}

package/utils/create-change-token.js

@@ -0,0 +1,21 @@
+/**
+ * Creates a change token for use with sites, webs, or lists
+ *
+ * @param resourceType The type of resource for which you want a change token
+ * @param resource The identifier (GUID) of the resource site.Id, web.Id, or List.Id
+ * @param tokenDate The date for this token (if start token, start date of chages; if end token, end date of the changes)
+ * @param versionNumber Version number for token (default = 1)
+ * @returns A properly formatted change token
+ */
+export function createChangeToken(resourceType = "site", resource, tokenDate = new Date(), versionNumber = 1) {
+    const resourceTypeMapping = new Map([["site", 1], ["web", 2], ["list", 3]]).get(resourceType);
+    // The value of the string assigned to ChangeTokenStart.StringValue is semicolon delimited, and takes the following parameters in the order listed:
+    // Version number.
+    // The change scope (0 - Content Database, 1 - site collection, 2 - site, 3 - list).
+    // GUID of the item the scope applies to (for example, GUID of the list).
+    // Time (in UTC) from when changes occurred in Ticks (but its .NET ticks so we do this math)
+    // Initialize the change item on the ChangeToken using a default value of -1.
+    const tokenDateTicks = (tokenDate.getTime() * 10000) + 621355968000000000;
+    return { StringValue: `${versionNumber};${resourceTypeMapping};${resource};${tokenDateTicks};-1` };
+}
+//# sourceMappingURL=create-change-token.js.map

package/utils/create-change-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-change-token.js","sourceRoot":"","sources":["../../../../packages/sp/utils/create-change-token.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,eAAwC,MAAM,EAAE,QAAgB,EAAE,YAAkB,IAAI,IAAI,EAAE,EAAE,aAAa,GAAG,CAAC;IAE/I,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAE9F,mJAAmJ;IACnJ,kBAAkB;IAClB,oFAAoF;IACpF,yEAAyE;IACzE,4FAA4F;IAC5F,6EAA6E;IAC7E,MAAM,cAAc,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,GAAG,kBAAkB,CAAC;IAC1E,OAAO,EAAE,WAAW,EAAE,GAAG,aAAa,IAAI,mBAAmB,IAAI,QAAQ,IAAI,cAAc,KAAK,EAAE,CAAC;AACvG,CAAC"}