microsoft-graph 3.11.21 → 3.12.23

package/README.md

@@ -6,17 +6,6 @@ This is an extensible library that allows access to Microsoft's GraphAPI, includ
 
 ℹ️ This is a THIRD PARTY library and not associated with Microsoft.
 
-## Breaking changes
-Version 2.25.0 has a few breaking changes:
-* **Signature change for `insertWorkbookCells` from `insertWorkbookCells(worksheetRef, address, shift)` to `insertWorkbookCells(rangeRef, shift)`**
-* `graphApi.ts` has moved to `services/operationInvoker.ts`
-* `NumberFormat` renamed to `CellFormat`
-* `Cell.numberFormat` renamed to `Cell.format`
-* `services/numberFormat.ts` moved to `services/cellFormat.ts`
-* Merged a number of files in `models` to reduce import count.
-* Removed return value from `setColumnHidden` and `setRowHidden`
-* `services/listDriveItems` now returns async iterable. Wrap this with `iterateToArray` if an array is actually desired.
-
 ## TLDR
 Install the NPM package `npm i microsoft-graph`, then:
 

package/dist/cjs/operations/driveItem/createDriveItemLink.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Create a sharing link for a drive item.
+ * @module createDriveItemLink
+ * @category Operations
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-createlink
+ */
+import type { Permission } from "@microsoft/microsoft-graph-types";
+import type { DriveItemRef } from "../../models/DriveItem.ts";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+/**
+ * The type of sharing link to create.
+ * Corresponds to the Microsoft Graph link 'type' parameter.
+ * @remarks See Microsoft Graph docs for supported values. Common types: view, edit, embed, blocksDownload, createOnly
+ */
+export type DriveItemLinkType = "view" | "edit" | "embed" | "blocksDownload" | "createOnly" | string;
+/**
+ * The scope of the sharing link.
+ * @remarks Supported scopes include: anonymous, organization, users (when specifying recipients)
+ */
+export type DriveItemLinkScope = "anonymous" | "organization" | "users" | string;
+/**
+ * Options when creating a sharing link for a drive item.
+ * Mirrors the Microsoft Graph createLink request body fields.
+ */
+export interface CreateDriveItemLinkOptions {
+    /** The type of link to create (e.g., view, edit). */
+    type: DriveItemLinkType;
+    /** The scope of the link (e.g., anonymous, organization, users). */
+    scope?: DriveItemLinkScope;
+    /** Password to set on the link (only for certain link types/scopes). */
+    password?: string;
+    /** Expiration date/time in ISO 8601 format. */
+    expirationDateTime?: string;
+}
+/**
+ * Create a sharing link for a drive item.
+ * @param itemRef Reference to the drive item.
+ * @param options Options specifying the desired link characteristics.
+ * @returns A Permission object describing the created link (including its webUrl and link properties).
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-createlink
+ */
+export default function createDriveItemLink(itemRef: DriveItemRef, options: CreateDriveItemLinkOptions): GraphOperation<Permission>;
+//# sourceMappingURL=createDriveItemLink.d.ts.map

package/dist/cjs/operations/driveItem/createDriveItemLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDriveItemLink.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/createDriveItemLink.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,gBAAgB,GAAG,YAAY,GAAG,MAAM,CAAC;AAErG;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjF;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IAC1C,qDAAqD;IACrD,IAAI,EAAE,iBAAiB,CAAC;IACxB,oEAAoE;IACpE,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,0BAA0B,GAAG,cAAc,CAAC,UAAU,CAAC,CAmBlI"}

package/dist/cjs/operations/driveItem/createDriveItemLink.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Create a sharing link for a drive item.
+ * @module createDriveItemLink
+ * @category Operations
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-createlink
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = createDriveItemLink;
+const operationInvoker_ts_1 = require("../../services/operationInvoker.js");
+const templatedPaths_ts_1 = require("../../services/templatedPaths.js");
+/**
+ * Create a sharing link for a drive item.
+ * @param itemRef Reference to the drive item.
+ * @param options Options specifying the desired link characteristics.
+ * @returns A Permission object describing the created link (including its webUrl and link properties).
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-createlink
+ */
+function createDriveItemLink(itemRef, options) {
+    const { type, scope, password, expirationDateTime } = options;
+    const body = { type };
+    // biome-ignore lint/complexity/useLiteralKeys: Literal keys are needed
+    if (scope)
+        body["scope"] = scope;
+    if (password)
+        body["password"] = password;
+    if (expirationDateTime)
+        body["expirationDateTime"] = expirationDateTime;
+    return (0, operationInvoker_ts_1.operation)({
+        context: itemRef.context,
+        method: "POST",
+        path: (0, templatedPaths_ts_1.generatePath)("/sites/{site-id}/drives/{drive-id}/items/{item-id}/createLink", itemRef),
+        headers: {
+            "content-type": "application/json",
+        },
+        body,
+        responseTransform: (response) => response,
+    });
+}

package/dist/esm/operations/driveItem/createDriveItemLink.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Create a sharing link for a drive item.
+ * @module createDriveItemLink
+ * @category Operations
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-createlink
+ */
+import type { Permission } from "@microsoft/microsoft-graph-types";
+import type { DriveItemRef } from "../../models/DriveItem.ts";
+import type { GraphOperation } from "../../models/GraphOperation.ts";
+/**
+ * The type of sharing link to create.
+ * Corresponds to the Microsoft Graph link 'type' parameter.
+ * @remarks See Microsoft Graph docs for supported values. Common types: view, edit, embed, blocksDownload, createOnly
+ */
+export type DriveItemLinkType = "view" | "edit" | "embed" | "blocksDownload" | "createOnly" | string;
+/**
+ * The scope of the sharing link.
+ * @remarks Supported scopes include: anonymous, organization, users (when specifying recipients)
+ */
+export type DriveItemLinkScope = "anonymous" | "organization" | "users" | string;
+/**
+ * Options when creating a sharing link for a drive item.
+ * Mirrors the Microsoft Graph createLink request body fields.
+ */
+export interface CreateDriveItemLinkOptions {
+    /** The type of link to create (e.g., view, edit). */
+    type: DriveItemLinkType;
+    /** The scope of the link (e.g., anonymous, organization, users). */
+    scope?: DriveItemLinkScope;
+    /** Password to set on the link (only for certain link types/scopes). */
+    password?: string;
+    /** Expiration date/time in ISO 8601 format. */
+    expirationDateTime?: string;
+}
+/**
+ * Create a sharing link for a drive item.
+ * @param itemRef Reference to the drive item.
+ * @param options Options specifying the desired link characteristics.
+ * @returns A Permission object describing the created link (including its webUrl and link properties).
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-createlink
+ */
+export default function createDriveItemLink(itemRef: DriveItemRef, options: CreateDriveItemLinkOptions): GraphOperation<Permission>;
+//# sourceMappingURL=createDriveItemLink.d.ts.map

package/dist/esm/operations/driveItem/createDriveItemLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createDriveItemLink.d.ts","sourceRoot":"","sources":["../../../../src/operations/driveItem/createDriveItemLink.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIrE;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,gBAAgB,GAAG,YAAY,GAAG,MAAM,CAAC;AAErG;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAEjF;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IAC1C,qDAAqD;IACrD,IAAI,EAAE,iBAAiB,CAAC;IACxB,oEAAoE;IACpE,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,0BAA0B,GAAG,cAAc,CAAC,UAAU,CAAC,CAmBlI"}

package/dist/esm/operations/driveItem/createDriveItemLink.js

@@ -0,0 +1,36 @@
+/**
+ * Create a sharing link for a drive item.
+ * @module createDriveItemLink
+ * @category Operations
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-createlink
+ */
+import { operation } from "../../services/operationInvoker.js";
+import { generatePath } from "../../services/templatedPaths.js";
+/**
+ * Create a sharing link for a drive item.
+ * @param itemRef Reference to the drive item.
+ * @param options Options specifying the desired link characteristics.
+ * @returns A Permission object describing the created link (including its webUrl and link properties).
+ * @see https://learn.microsoft.com/en-us/graph/api/driveitem-createlink
+ */
+export default function createDriveItemLink(itemRef, options) {
+    const { type, scope, password, expirationDateTime } = options;
+    const body = { type };
+    // biome-ignore lint/complexity/useLiteralKeys: Literal keys are needed
+    if (scope)
+        body["scope"] = scope;
+    if (password)
+        body["password"] = password;
+    if (expirationDateTime)
+        body["expirationDateTime"] = expirationDateTime;
+    return operation({
+        context: itemRef.context,
+        method: "POST",
+        path: generatePath("/sites/{site-id}/drives/{drive-id}/items/{item-id}/createLink", itemRef),
+        headers: {
+            "content-type": "application/json",
+        },
+        body,
+        responseTransform: (response) => response,
+    });
+}

package/docs/api/README.md

@@ -81,6 +81,7 @@
 | [closeWorkbookSession](closeWorkbookSession.md) | Close an existing workbook session. |
 | [createBinaryWorkbook](createBinaryWorkbook.md) | Create a new blank binary workbook (XLSB). |
 | [createDriveItemContent](createDriveItemContent.md) | Creates a new drive item in the specified parent drive or folder using a stream as content. |
+| [createDriveItemLink](createDriveItemLink.md) | Create a sharing link for a drive item. |
 | [createFolder](createFolder.md) | Create a folder in the root of a drive, or in a folder. If it already exists do nothing. |
 | [createWorkbook](createWorkbook.md) | Create a new blank workbook (XLSX). |
 | [createWorkbookSession](createWorkbookSession.md) | Create a new workbook session. |

package/docs/api/createDriveItemLink.md

@@ -0,0 +1,108 @@
+[Microsoft Graph SDK](README.md) / createDriveItemLink
+
+# createDriveItemLink
+
+Create a sharing link for a drive item.
+
+## See
+
+https://learn.microsoft.com/en-us/graph/api/driveitem-createlink
+
+## Interfaces
+
+### CreateDriveItemLinkOptions
+
+Defined in: [src/operations/driveItem/createDriveItemLink.ts:31](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/driveItem/createDriveItemLink.ts#L31)
+
+Options when creating a sharing link for a drive item.
+Mirrors the Microsoft Graph createLink request body fields.
+
+#### Properties
+
+##### expirationDateTime?
+
+> `optional` **expirationDateTime**: `string`
+
+Defined in: [src/operations/driveItem/createDriveItemLink.ts:39](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/driveItem/createDriveItemLink.ts#L39)
+
+Expiration date/time in ISO 8601 format.
+
+##### password?
+
+> `optional` **password**: `string`
+
+Defined in: [src/operations/driveItem/createDriveItemLink.ts:37](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/driveItem/createDriveItemLink.ts#L37)
+
+Password to set on the link (only for certain link types/scopes).
+
+##### scope?
+
+> `optional` **scope**: `string`
+
+Defined in: [src/operations/driveItem/createDriveItemLink.ts:35](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/driveItem/createDriveItemLink.ts#L35)
+
+The scope of the link (e.g., anonymous, organization, users).
+
+##### type
+
+> **type**: `string`
+
+Defined in: [src/operations/driveItem/createDriveItemLink.ts:33](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/driveItem/createDriveItemLink.ts#L33)
+
+The type of link to create (e.g., view, edit).
+
+## Type Aliases
+
+### DriveItemLinkScope
+
+> **DriveItemLinkScope** = `"anonymous"` \| `"organization"` \| `"users"` \| `string`
+
+Defined in: [src/operations/driveItem/createDriveItemLink.ts:25](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/driveItem/createDriveItemLink.ts#L25)
+
+The scope of the sharing link.
+
+#### Remarks
+
+Supported scopes include: anonymous, organization, users (when specifying recipients)
+
+***
+
+### DriveItemLinkType
+
+> **DriveItemLinkType** = `"view"` \| `"edit"` \| `"embed"` \| `"blocksDownload"` \| `"createOnly"` \| `string`
+
+Defined in: [src/operations/driveItem/createDriveItemLink.ts:19](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/driveItem/createDriveItemLink.ts#L19)
+
+The type of sharing link to create.
+Corresponds to the Microsoft Graph link 'type' parameter.
+
+#### Remarks
+
+See Microsoft Graph docs for supported values. Common types: view, edit, embed, blocksDownload, createOnly
+
+## Functions
+
+### createDriveItemLink()
+
+> **createDriveItemLink**(`itemRef`, `options`): [`GraphOperation`](GraphOperation.md#graphoperation)\<`Permission`\>
+
+Defined in: [src/operations/driveItem/createDriveItemLink.ts:49](https://github.com/Future-Secure-AI/microsoft-graph/blob/main/src/operations/driveItem/createDriveItemLink.ts#L49)
+
+Create a sharing link for a drive item.
+
+#### Parameters
+
+| Parameter | Type | Description |
+| ------ | ------ | ------ |
+| `itemRef` | [`DriveItemRef`](DriveItem-1.md#driveitemref) | Reference to the drive item. |
+| `options` | [`CreateDriveItemLinkOptions`](#createdriveitemlinkoptions) | Options specifying the desired link characteristics. |
+
+#### Returns
+
+[`GraphOperation`](GraphOperation.md#graphoperation)\<`Permission`\>
+
+A Permission object describing the created link (including its webUrl and link properties).
+
+#### See
+
+https://learn.microsoft.com/en-us/graph/api/driveitem-createlink

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "microsoft-graph",
-	"version": "3.11.21",
+	"version": "3.12.23",
 	"description": "Microsoft GraphAPI SDK for NodeJS",
 	"main": "./dist/cjs/index.js",
 	"module": "./dist/esm/index.js",
@@ -686,6 +686,16 @@
 			"require": "./dist/cjs/operations/driveItem/createDriveItemContent.js",
 			"types": "./dist/esm/operations/driveItem/createDriveItemContent.d.ts"
 		},
+		"./createDriveItemLink": {
+			"import": "./dist/esm/operations/driveItem/createDriveItemLink.js",
+			"require": "./dist/cjs/operations/driveItem/createDriveItemLink.js",
+			"types": "./dist/esm/operations/driveItem/createDriveItemLink.d.ts"
+		},
+		"./dist/cjs/operations/driveItem/createDriveItemLink": {
+			"import": "./dist/esm/operations/driveItem/createDriveItemLink.js",
+			"require": "./dist/cjs/operations/driveItem/createDriveItemLink.js",
+			"types": "./dist/esm/operations/driveItem/createDriveItemLink.d.ts"
+		},
 		"./deleteDriveItem": {
 			"import": "./dist/esm/operations/driveItem/deleteDriveItem.js",
 			"require": "./dist/cjs/operations/driveItem/deleteDriveItem.js",