@keboola/api-client 31.0.0 → 33.0.0

package/dist/microsoftGraph/index.cjs

@@ -0,0 +1,92 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_createFetchClient = require("../createFetchClient-DvZvD31l.cjs");
+const require_createOpenapiFetchClient = require("../createOpenapiFetchClient-C57Ljzi6.cjs");
+//#region src/clients/microsoftGraph/utils.ts
+const encodeSharingUrl = (sharingUrl) => {
+	const binary = String.fromCharCode(...new TextEncoder().encode(sharingUrl));
+	return `u!${btoa(binary).replace(/=+$/, "").replace(/\//g, "_").replace(/\+/g, "-")}`;
+};
+//#endregion
+//#region src/clients/microsoftGraph/microsoftGraphClient.ts
+const MICROSOFT_GRAPH_BASE_URL = "https://graph.microsoft.com/v1.0";
+const DRIVE_ITEM_SELECT = [
+	"id",
+	"name",
+	"parentReference"
+];
+const ODATA_QUERY = { queryArrayFormat: "comma" };
+const createMicrosoftGraphClient = ({ baseUrl = MICROSOFT_GRAPH_BASE_URL, middlewares = [] } = {}) => {
+	const client = require_createOpenapiFetchClient.createOpenapiFetchClient({
+		baseUrl,
+		middlewares
+	});
+	const getMySite = async (signal) => {
+		const { data } = await client.get("/me", { query: { $select: ["mySite"] } }, {
+			signal,
+			...ODATA_QUERY
+		});
+		return data;
+	};
+	const getMyDrive = async (signal) => {
+		const { data } = await client.get("/me/drive", { query: { $select: ["webUrl"] } }, {
+			signal,
+			...ODATA_QUERY
+		});
+		return data;
+	};
+	const getFile = async (driveId, fileId, signal) => {
+		const { data } = await client.get("/drives/{drive-id}/items/{driveItem-id}", {
+			path: {
+				"drive-id": driveId,
+				"driveItem-id": fileId
+			},
+			query: { $select: DRIVE_ITEM_SELECT }
+		}, {
+			signal,
+			...ODATA_QUERY
+		});
+		return data;
+	};
+	/**
+	* Resolves the real DriveItem (id + parentReference.driveId) for a shared item a file picker
+	* returned with empty ids (e.g. "Shared with me" SharePoint files).
+	*/
+	const getDriveItemBySharingUrl = async (sharingUrl, signal) => {
+		const { data } = await client.get("/shares/{sharedDriveItem-id}/driveItem", {
+			path: { "sharedDriveItem-id": encodeSharingUrl(sharingUrl) },
+			query: { $select: DRIVE_ITEM_SELECT }
+		}, {
+			signal,
+			...ODATA_QUERY,
+			headers: { Prefer: "redeemSharingLinkIfNecessary" }
+		});
+		return data;
+	};
+	return {
+		getMySite,
+		getMyDrive,
+		getFile,
+		getDriveItemBySharingUrl
+	};
+};
+//#endregion
+//#region src/clients/microsoftGraph/middleware.ts
+/**
+* Stamps a Graph access token as `Authorization: Bearer …`.
+*
+* There is deliberately no refresh-and-replay here, and no `sdks/microsoftGraph/` to own one: the
+* consumer's OAuth library (MSAL in the browser) mints and refreshes these tokens per user
+* interaction, so this package holds no token state to manage. It exists so the client can take a
+* `MiddlewareFn` rather than a credential, without every consumer restating the header.
+*/
+const createMicrosoftGraphAuthMiddleware = (accessToken) => {
+	return (next) => async (request) => {
+		request.request.headers.set(require_createFetchClient.HttpHeader.AUTHORIZATION, `Bearer ${accessToken}`);
+		return next(request);
+	};
+};
+//#endregion
+exports.createMicrosoftGraphAuthMiddleware = createMicrosoftGraphAuthMiddleware;
+exports.createMicrosoftGraphClient = createMicrosoftGraphClient;
+
+//# sourceMappingURL=index.cjs.map

package/dist/microsoftGraph/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["createOpenapiFetchClient","HttpHeader"],"sources":["../../src/clients/microsoftGraph/utils.ts","../../src/clients/microsoftGraph/microsoftGraphClient.ts","../../src/clients/microsoftGraph/middleware.ts"],"sourcesContent":["// Encode a sharing URL into a Graph sharing token: base64 of the UTF-8 bytes, converted to\n// unpadded base64url, prefixed with `u!`. TextEncoder keeps non-ASCII file names (e.g. ä, č) valid.\n// https://learn.microsoft.com/en-us/graph/api/shares-get#encoding-sharing-urls\nexport const encodeSharingUrl = (sharingUrl: string) => {\n  const binary = String.fromCharCode(...new TextEncoder().encode(sharingUrl));\n  const base64 = btoa(binary).replace(/=+$/, '').replace(/\\//g, '_').replace(/\\+/g, '-');\n  return `u!${base64}`;\n};\n","import { createOpenapiFetchClient } from '../../fetchClient';\nimport type { ClientInitOptions } from '../types';\n\nimport type { paths } from './__generated__/schema';\nimport { encodeSharingUrl } from './utils';\n\n// Microsoft Graph is not a Keboola service, so unlike a stack client this base URL is not\n// discovered — the version prefix is part of Graph's own API contract. Overridable for tests.\nconst MICROSOFT_GRAPH_BASE_URL = 'https://graph.microsoft.com/v1.0';\n\nconst DRIVE_ITEM_SELECT = ['id', 'name', 'parentReference'];\n\n// OData wants `$select=id,name` — the default array format would send `$select[0]=id`.\nconst ODATA_QUERY = { queryArrayFormat: 'comma' } as const;\n\n/**\n * Auth arrives as a middleware, never as a token: a client here holds no credential. Pair it with\n * `createMicrosoftGraphAuthMiddleware`, which the consumer builds from the token its OAuth flow\n * just minted — Graph tokens are per user interaction and scoped to one account, so a client is\n * built per interaction rather than shared.\n */\ntype MicrosoftGraphClientOptions = Partial<Omit<ClientInitOptions, 'auth'>>;\n\nexport const createMicrosoftGraphClient = ({\n  baseUrl = MICROSOFT_GRAPH_BASE_URL,\n  middlewares = [],\n}: MicrosoftGraphClientOptions = {}) => {\n  const client = createOpenapiFetchClient<paths>({ baseUrl, middlewares });\n\n  const getMySite = async (signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/me',\n      { query: { $select: ['mySite'] } },\n      { signal, ...ODATA_QUERY },\n    );\n\n    return data;\n  };\n\n  const getMyDrive = async (signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/me/drive',\n      { query: { $select: ['webUrl'] } },\n      { signal, ...ODATA_QUERY },\n    );\n\n    return data;\n  };\n\n  const getFile = async (driveId: string, fileId: string, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/drives/{drive-id}/items/{driveItem-id}',\n      {\n        path: { 'drive-id': driveId, 'driveItem-id': fileId },\n        query: { $select: DRIVE_ITEM_SELECT },\n      },\n      { signal, ...ODATA_QUERY },\n    );\n\n    return data;\n  };\n\n  /**\n   * Resolves the real DriveItem (id + parentReference.driveId) for a shared item a file picker\n   * returned with empty ids (e.g. \"Shared with me\" SharePoint files).\n   */\n  const getDriveItemBySharingUrl = async (sharingUrl: string, signal?: AbortSignal) => {\n    const { data } = await client.get(\n      '/shares/{sharedDriveItem-id}/driveItem',\n      {\n        path: { 'sharedDriveItem-id': encodeSharingUrl(sharingUrl) },\n        query: { $select: DRIVE_ITEM_SELECT },\n      },\n      // Graph only redeems a sharing link into a DriveItem when asked to.\n      { signal, ...ODATA_QUERY, headers: { Prefer: 'redeemSharingLinkIfNecessary' } },\n    );\n\n    return data;\n  };\n\n  return {\n    getMySite,\n    getMyDrive,\n    getFile,\n    getDriveItemBySharingUrl,\n  };\n};\n","import { HttpHeader, type MiddlewareFn } from '../../fetchClient';\n\n/**\n * Stamps a Graph access token as `Authorization: Bearer …`.\n *\n * There is deliberately no refresh-and-replay here, and no `sdks/microsoftGraph/` to own one: the\n * consumer's OAuth library (MSAL in the browser) mints and refreshes these tokens per user\n * interaction, so this package holds no token state to manage. It exists so the client can take a\n * `MiddlewareFn` rather than a credential, without every consumer restating the header.\n */\nexport const createMicrosoftGraphAuthMiddleware = (accessToken: string): MiddlewareFn => {\n  return (next) => async (request) => {\n    request.request.headers.set(HttpHeader.AUTHORIZATION, `Bearer ${accessToken}`);\n    return next(request);\n  };\n};\n"],"mappings":";;;;AAGA,MAAa,oBAAoB,eAAuB;CACtD,MAAM,SAAS,OAAO,aAAa,GAAG,IAAI,YAAY,CAAC,CAAC,OAAO,UAAU,CAAC;CAE1E,OAAO,KADQ,KAAK,MAAM,CAAC,CAAC,QAAQ,OAAO,EAAE,CAAC,CAAC,QAAQ,OAAO,GAAG,CAAC,CAAC,QAAQ,OAAO,GACjE;AACnB;;;ACCA,MAAM,2BAA2B;AAEjC,MAAM,oBAAoB;CAAC;CAAM;CAAQ;AAAiB;AAG1D,MAAM,cAAc,EAAE,kBAAkB,QAAQ;AAUhD,MAAa,8BAA8B,EACzC,UAAU,0BACV,cAAc,CAAC,MACgB,CAAC,MAAM;CACtC,MAAM,SAASA,iCAAAA,yBAAgC;EAAE;EAAS;CAAY,CAAC;CAEvE,MAAM,YAAY,OAAO,WAAyB;EAChD,MAAM,EAAE,SAAS,MAAM,OAAO,IAC5B,OACA,EAAE,OAAO,EAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,GACjC;GAAE;GAAQ,GAAG;EAAY,CAC3B;EAEA,OAAO;CACT;CAEA,MAAM,aAAa,OAAO,WAAyB;EACjD,MAAM,EAAE,SAAS,MAAM,OAAO,IAC5B,aACA,EAAE,OAAO,EAAE,SAAS,CAAC,QAAQ,EAAE,EAAE,GACjC;GAAE;GAAQ,GAAG;EAAY,CAC3B;EAEA,OAAO;CACT;CAEA,MAAM,UAAU,OAAO,SAAiB,QAAgB,WAAyB;EAC/E,MAAM,EAAE,SAAS,MAAM,OAAO,IAC5B,2CACA;GACE,MAAM;IAAE,YAAY;IAAS,gBAAgB;GAAO;GACpD,OAAO,EAAE,SAAS,kBAAkB;EACtC,GACA;GAAE;GAAQ,GAAG;EAAY,CAC3B;EAEA,OAAO;CACT;;;;;CAMA,MAAM,2BAA2B,OAAO,YAAoB,WAAyB;EACnF,MAAM,EAAE,SAAS,MAAM,OAAO,IAC5B,0CACA;GACE,MAAM,EAAE,sBAAsB,iBAAiB,UAAU,EAAE;GAC3D,OAAO,EAAE,SAAS,kBAAkB;EACtC,GAEA;GAAE;GAAQ,GAAG;GAAa,SAAS,EAAE,QAAQ,+BAA+B;EAAE,CAChF;EAEA,OAAO;CACT;CAEA,OAAO;EACL;EACA;EACA;EACA;CACF;AACF;;;;;;;;;;;AC5EA,MAAa,sCAAsC,gBAAsC;CACvF,QAAQ,SAAS,OAAO,YAAY;EAClC,QAAQ,QAAQ,QAAQ,IAAIC,0BAAAA,WAAW,eAAe,UAAU,aAAa;EAC7E,OAAO,KAAK,OAAO;CACrB;AACF"}

package/dist/microsoftGraph/index.d.cts

@@ -0,0 +1,305 @@
+import { E as MiddlewareFn } from "../index-DhVFuQDv.cjs";
+import { n as ClientInitOptions } from "../types-DHI0g51U.cjs";
+import { t as components } from "../schema-D1oxyn1O.cjs";
+//#region src/clients/microsoftGraph/microsoftGraphClient.d.ts
+/**
+ * Auth arrives as a middleware, never as a token: a client here holds no credential. Pair it with
+ * `createMicrosoftGraphAuthMiddleware`, which the consumer builds from the token its OAuth flow
+ * just minted — Graph tokens are per user interaction and scoped to one account, so a client is
+ * built per interaction rather than shared.
+ */
+type MicrosoftGraphClientOptions = Partial<Omit<ClientInitOptions, 'auth'>>;
+declare const createMicrosoftGraphClient: ({ baseUrl, middlewares }?: MicrosoftGraphClientOptions) => {
+  getMySite: (signal?: AbortSignal) => Promise<{
+    id?: string;
+    '@odata.type': string;
+  } & {
+    deletedDateTime?: string | null;
+    '@odata.type': string;
+  } & {
+    aboutMe?: string | null;
+    accountEnabled?: boolean | null;
+    ageGroup?: string | null;
+    assignedLicenses?: components['schemas']['microsoft.graph.assignedLicense'][];
+    assignedPlans?: components['schemas']['microsoft.graph.assignedPlan'][];
+    authorizationInfo?: components['schemas']['microsoft.graph.authorizationInfo'] | (Record<string, never> | null);
+    birthday?: string;
+    businessPhones?: string[];
+    city?: string | null;
+    companyName?: string | null;
+    consentProvidedForMinor?: string | null;
+    country?: string | null;
+    createdDateTime?: string | null;
+    creationType?: string | null;
+    customSecurityAttributes?: components['schemas']['microsoft.graph.customSecurityAttributeValue'] | (Record<string, never> | null);
+    department?: string | null;
+    deviceEnrollmentLimit?: number;
+    displayName?: string | null;
+    employeeHireDate?: string | null;
+    employeeId?: string | null;
+    employeeLeaveDateTime?: string | null;
+    employeeOrgData?: components['schemas']['microsoft.graph.employeeOrgData'] | (Record<string, never> | null);
+    employeeType?: string | null;
+    externalUserState?: string | null;
+    externalUserStateChangeDateTime?: string | null;
+    faxNumber?: string | null;
+    givenName?: string | null;
+    hireDate?: string;
+    identities?: components['schemas']['microsoft.graph.objectIdentity'][];
+    identityParentId?: string | null;
+    imAddresses?: (string | null)[];
+    interests?: (string | null)[];
+    isManagementRestricted?: boolean | null;
+    isResourceAccount?: boolean | null;
+    jobTitle?: string | null;
+    lastPasswordChangeDateTime?: string | null;
+    legalAgeGroupClassification?: string | null;
+    licenseAssignmentStates?: components['schemas']['microsoft.graph.licenseAssignmentState'][];
+    mail?: string | null;
+    mailboxSettings?: components['schemas']['microsoft.graph.mailboxSettings'] | (Record<string, never> | null);
+    mailNickname?: string | null;
+    mobilePhone?: string | null;
+    mySite?: string | null;
+    officeLocation?: string | null;
+    onPremisesDistinguishedName?: string | null;
+    onPremisesDomainName?: string | null;
+    onPremisesExtensionAttributes?: components['schemas']['microsoft.graph.onPremisesExtensionAttributes'] | (Record<string, never> | null);
+    onPremisesImmutableId?: string | null;
+    onPremisesLastSyncDateTime?: string | null;
+    onPremisesProvisioningErrors?: components['schemas']['microsoft.graph.onPremisesProvisioningError'][];
+    onPremisesSamAccountName?: string | null;
+    onPremisesSecurityIdentifier?: string | null;
+    onPremisesSyncEnabled?: boolean | null;
+    onPremisesUserPrincipalName?: string | null;
+    otherMails?: string[];
+    passwordPolicies?: string | null;
+    passwordProfile?: components['schemas']['microsoft.graph.passwordProfile'] | (Record<string, never> | null);
+    pastProjects?: (string | null)[];
+    postalCode?: string | null;
+    preferredDataLocation?: string | null;
+    preferredLanguage?: string | null;
+    preferredName?: string | null;
+    print?: components['schemas']['microsoft.graph.userPrint'] | (Record<string, never> | null);
+    provisionedPlans?: components['schemas']['microsoft.graph.provisionedPlan'][];
+    proxyAddresses?: string[];
+    responsibilities?: (string | null)[];
+    schools?: (string | null)[];
+    securityIdentifier?: string | null;
+    serviceProvisioningErrors?: components['schemas']['microsoft.graph.serviceProvisioningError'][];
+    showInAddressList?: boolean | null;
+    signInActivity?: components['schemas']['microsoft.graph.signInActivity'] | (Record<string, never> | null);
+    signInSessionsValidFromDateTime?: string | null;
+    skills?: (string | null)[];
+    state?: string | null;
+    streetAddress?: string | null;
+    surname?: string | null;
+    usageLocation?: string | null;
+    userPrincipalName?: string | null;
+    userType?: string | null;
+    activities?: components['schemas']['microsoft.graph.userActivity'][];
+    adhocCalls?: components['schemas']['microsoft.graph.adhocCall'][];
+    agreementAcceptances?: components['schemas']['microsoft.graph.agreementAcceptance'][];
+    appRoleAssignments?: components['schemas']['microsoft.graph.appRoleAssignment'][];
+    authentication?: components['schemas']['microsoft.graph.authentication'] | (Record<string, never> | null);
+    calendar?: components['schemas']['microsoft.graph.calendar'] | (Record<string, never> | null);
+    calendarGroups?: components['schemas']['microsoft.graph.calendarGroup'][];
+    calendars?: components['schemas']['microsoft.graph.calendar'][];
+    calendarView?: components['schemas']['microsoft.graph.event'][];
+    chats?: components['schemas']['microsoft.graph.chat'][];
+    cloudClipboard?: components['schemas']['microsoft.graph.cloudClipboardRoot'] | (Record<string, never> | null);
+    cloudPCs?: components['schemas']['microsoft.graph.cloudPC'][];
+    contactFolders?: components['schemas']['microsoft.graph.contactFolder'][];
+    contacts?: components['schemas']['microsoft.graph.contact'][];
+    createdObjects?: components['schemas']['microsoft.graph.directoryObject'][];
+    dataSecurityAndGovernance?: components['schemas']['microsoft.graph.userDataSecurityAndGovernance'] | (Record<string, never> | null);
+    deviceManagementTroubleshootingEvents?: components['schemas']['microsoft.graph.deviceManagementTroubleshootingEvent'][];
+    directReports?: components['schemas']['microsoft.graph.directoryObject'][];
+    drive?: components['schemas']['microsoft.graph.drive'] | (Record<string, never> | null);
+    drives?: components['schemas']['microsoft.graph.drive'][];
+    employeeExperience?: components['schemas']['microsoft.graph.employeeExperienceUser'] | (Record<string, never> | null);
+    events?: components['schemas']['microsoft.graph.event'][];
+    extensions?: components['schemas']['microsoft.graph.extension'][];
+    followedSites?: components['schemas']['microsoft.graph.site'][];
+    inferenceClassification?: components['schemas']['microsoft.graph.inferenceClassification'] | (Record<string, never> | null);
+    insights?: components['schemas']['microsoft.graph.itemInsights'] | (Record<string, never> | null);
+    joinedTeams?: components['schemas']['microsoft.graph.team'][];
+    licenseDetails?: components['schemas']['microsoft.graph.licenseDetails'][];
+    mailFolders?: components['schemas']['microsoft.graph.mailFolder'][];
+    managedAppRegistrations?: components['schemas']['microsoft.graph.managedAppRegistration'][];
+    managedDevices?: components['schemas']['microsoft.graph.managedDevice'][];
+    manager?: components['schemas']['microsoft.graph.directoryObject'] | (Record<string, never> | null);
+    memberOf?: components['schemas']['microsoft.graph.directoryObject'][];
+    messages?: components['schemas']['microsoft.graph.message'][];
+    oauth2PermissionGrants?: components['schemas']['microsoft.graph.oAuth2PermissionGrant'][];
+    onenote?: components['schemas']['microsoft.graph.onenote'] | (Record<string, never> | null);
+    onlineMeetings?: components['schemas']['microsoft.graph.onlineMeeting'][];
+    onPremisesSyncBehavior?: components['schemas']['microsoft.graph.onPremisesSyncBehavior'] | (Record<string, never> | null);
+    outlook?: components['schemas']['microsoft.graph.outlookUser'] | (Record<string, never> | null);
+    ownedDevices?: components['schemas']['microsoft.graph.directoryObject'][];
+    ownedObjects?: components['schemas']['microsoft.graph.directoryObject'][];
+    people?: components['schemas']['microsoft.graph.person'][];
+    permissionGrants?: components['schemas']['microsoft.graph.resourceSpecificPermissionGrant'][];
+    photo?: components['schemas']['microsoft.graph.profilePhoto'] | (Record<string, never> | null);
+    photos?: components['schemas']['microsoft.graph.profilePhoto'][];
+    planner?: components['schemas']['microsoft.graph.plannerUser'] | (Record<string, never> | null);
+    presence?: components['schemas']['microsoft.graph.presence'] | (Record<string, never> | null);
+    registeredDevices?: components['schemas']['microsoft.graph.directoryObject'][];
+    scopedRoleMemberOf?: components['schemas']['microsoft.graph.scopedRoleMembership'][];
+    settings?: components['schemas']['microsoft.graph.userSettings'] | (Record<string, never> | null);
+    solutions?: components['schemas']['microsoft.graph.userSolutionRoot'] | (Record<string, never> | null);
+    sponsorOf?: components['schemas']['microsoft.graph.directoryObject'][];
+    sponsors?: components['schemas']['microsoft.graph.directoryObject'][];
+    teamwork?: components['schemas']['microsoft.graph.userTeamwork'] | (Record<string, never> | null);
+    todo?: components['schemas']['microsoft.graph.todo'] | (Record<string, never> | null);
+    transitiveMemberOf?: components['schemas']['microsoft.graph.directoryObject'][];
+    '@odata.type': string;
+  }>;
+  getMyDrive: (signal?: AbortSignal) => Promise<{
+    id?: string;
+    '@odata.type': string;
+  } & {
+    createdBy?: components['schemas']['microsoft.graph.identitySet'] | (Record<string, never> | null);
+    createdDateTime?: string;
+    description?: string | null;
+    eTag?: string | null;
+    lastModifiedBy?: components['schemas']['microsoft.graph.identitySet'] | (Record<string, never> | null);
+    lastModifiedDateTime?: string;
+    name?: string | null;
+    parentReference?: components['schemas']['microsoft.graph.itemReference'] | (Record<string, never> | null);
+    webUrl?: string | null;
+    createdByUser?: components['schemas']['microsoft.graph.user'] | (Record<string, never> | null);
+    lastModifiedByUser?: components['schemas']['microsoft.graph.user'] | (Record<string, never> | null);
+    '@odata.type': string;
+  } & {
+    driveType?: string | null;
+    owner?: components['schemas']['microsoft.graph.identitySet'] | (Record<string, never> | null);
+    quota?: components['schemas']['microsoft.graph.quota'] | (Record<string, never> | null);
+    sharePointIds?: components['schemas']['microsoft.graph.sharepointIds'] | (Record<string, never> | null);
+    system?: components['schemas']['microsoft.graph.systemFacet'] | (Record<string, never> | null);
+    bundles?: components['schemas']['microsoft.graph.driveItem'][];
+    following?: components['schemas']['microsoft.graph.driveItem'][];
+    items?: components['schemas']['microsoft.graph.driveItem'][];
+    list?: components['schemas']['microsoft.graph.list'] | (Record<string, never> | null);
+    root?: components['schemas']['microsoft.graph.driveItem'] | (Record<string, never> | null);
+    special?: components['schemas']['microsoft.graph.driveItem'][];
+    '@odata.type': string;
+  }>;
+  getFile: (driveId: string, fileId: string, signal?: AbortSignal) => Promise<{
+    id?: string;
+    '@odata.type': string;
+  } & {
+    createdBy?: components['schemas']['microsoft.graph.identitySet'] | (Record<string, never> | null);
+    createdDateTime?: string;
+    description?: string | null;
+    eTag?: string | null;
+    lastModifiedBy?: components['schemas']['microsoft.graph.identitySet'] | (Record<string, never> | null);
+    lastModifiedDateTime?: string;
+    name?: string | null;
+    parentReference?: components['schemas']['microsoft.graph.itemReference'] | (Record<string, never> | null);
+    webUrl?: string | null;
+    createdByUser?: components['schemas']['microsoft.graph.user'] | (Record<string, never> | null);
+    lastModifiedByUser?: components['schemas']['microsoft.graph.user'] | (Record<string, never> | null);
+    '@odata.type': string;
+  } & {
+    audio?: components['schemas']['microsoft.graph.audio'] | (Record<string, never> | null);
+    bundle?: components['schemas']['microsoft.graph.bundle'] | (Record<string, never> | null);
+    content?: string | null;
+    cTag?: string | null;
+    deleted?: components['schemas']['microsoft.graph.deleted'] | (Record<string, never> | null);
+    file?: components['schemas']['microsoft.graph.file'] | (Record<string, never> | null);
+    fileSystemInfo?: components['schemas']['microsoft.graph.fileSystemInfo'] | (Record<string, never> | null);
+    folder?: components['schemas']['microsoft.graph.folder'] | (Record<string, never> | null);
+    image?: components['schemas']['microsoft.graph.image'] | (Record<string, never> | null);
+    location?: components['schemas']['microsoft.graph.geoCoordinates'] | (Record<string, never> | null);
+    malware?: components['schemas']['microsoft.graph.malware'] | (Record<string, never> | null);
+    package?: components['schemas']['microsoft.graph.package'] | (Record<string, never> | null);
+    pendingOperations?: components['schemas']['microsoft.graph.pendingOperations'] | (Record<string, never> | null);
+    photo?: components['schemas']['microsoft.graph.photo'] | (Record<string, never> | null);
+    publication?: components['schemas']['microsoft.graph.publicationFacet'] | (Record<string, never> | null);
+    remoteItem?: components['schemas']['microsoft.graph.remoteItem'] | (Record<string, never> | null);
+    root?: components['schemas']['microsoft.graph.root'] | (Record<string, never> | null);
+    searchResult?: components['schemas']['microsoft.graph.searchResult'] | (Record<string, never> | null);
+    shared?: components['schemas']['microsoft.graph.shared'] | (Record<string, never> | null);
+    sharepointIds?: components['schemas']['microsoft.graph.sharepointIds'] | (Record<string, never> | null);
+    size?: number | null;
+    specialFolder?: components['schemas']['microsoft.graph.specialFolder'] | (Record<string, never> | null);
+    video?: components['schemas']['microsoft.graph.video'] | (Record<string, never> | null);
+    webDavUrl?: string | null;
+    analytics?: components['schemas']['microsoft.graph.itemAnalytics'] | (Record<string, never> | null);
+    children?: components['schemas']['microsoft.graph.driveItem'][];
+    listItem?: components['schemas']['microsoft.graph.listItem'] | (Record<string, never> | null);
+    permissions?: components['schemas']['microsoft.graph.permission'][];
+    retentionLabel?: components['schemas']['microsoft.graph.itemRetentionLabel'] | (Record<string, never> | null);
+    subscriptions?: components['schemas']['microsoft.graph.subscription'][];
+    thumbnails?: components['schemas']['microsoft.graph.thumbnailSet'][];
+    versions?: components['schemas']['microsoft.graph.driveItemVersion'][];
+    workbook?: components['schemas']['microsoft.graph.workbook'] | (Record<string, never> | null);
+    '@odata.type': string;
+  }>;
+  getDriveItemBySharingUrl: (sharingUrl: string, signal?: AbortSignal) => Promise<{
+    id?: string;
+    '@odata.type': string;
+  } & {
+    createdBy?: components['schemas']['microsoft.graph.identitySet'] | (Record<string, never> | null);
+    createdDateTime?: string;
+    description?: string | null;
+    eTag?: string | null;
+    lastModifiedBy?: components['schemas']['microsoft.graph.identitySet'] | (Record<string, never> | null);
+    lastModifiedDateTime?: string;
+    name?: string | null;
+    parentReference?: components['schemas']['microsoft.graph.itemReference'] | (Record<string, never> | null);
+    webUrl?: string | null;
+    createdByUser?: components['schemas']['microsoft.graph.user'] | (Record<string, never> | null);
+    lastModifiedByUser?: components['schemas']['microsoft.graph.user'] | (Record<string, never> | null);
+    '@odata.type': string;
+  } & {
+    audio?: components['schemas']['microsoft.graph.audio'] | (Record<string, never> | null);
+    bundle?: components['schemas']['microsoft.graph.bundle'] | (Record<string, never> | null);
+    content?: string | null;
+    cTag?: string | null;
+    deleted?: components['schemas']['microsoft.graph.deleted'] | (Record<string, never> | null);
+    file?: components['schemas']['microsoft.graph.file'] | (Record<string, never> | null);
+    fileSystemInfo?: components['schemas']['microsoft.graph.fileSystemInfo'] | (Record<string, never> | null);
+    folder?: components['schemas']['microsoft.graph.folder'] | (Record<string, never> | null);
+    image?: components['schemas']['microsoft.graph.image'] | (Record<string, never> | null);
+    location?: components['schemas']['microsoft.graph.geoCoordinates'] | (Record<string, never> | null);
+    malware?: components['schemas']['microsoft.graph.malware'] | (Record<string, never> | null);
+    package?: components['schemas']['microsoft.graph.package'] | (Record<string, never> | null);
+    pendingOperations?: components['schemas']['microsoft.graph.pendingOperations'] | (Record<string, never> | null);
+    photo?: components['schemas']['microsoft.graph.photo'] | (Record<string, never> | null);
+    publication?: components['schemas']['microsoft.graph.publicationFacet'] | (Record<string, never> | null);
+    remoteItem?: components['schemas']['microsoft.graph.remoteItem'] | (Record<string, never> | null);
+    root?: components['schemas']['microsoft.graph.root'] | (Record<string, never> | null);
+    searchResult?: components['schemas']['microsoft.graph.searchResult'] | (Record<string, never> | null);
+    shared?: components['schemas']['microsoft.graph.shared'] | (Record<string, never> | null);
+    sharepointIds?: components['schemas']['microsoft.graph.sharepointIds'] | (Record<string, never> | null);
+    size?: number | null;
+    specialFolder?: components['schemas']['microsoft.graph.specialFolder'] | (Record<string, never> | null);
+    video?: components['schemas']['microsoft.graph.video'] | (Record<string, never> | null);
+    webDavUrl?: string | null;
+    analytics?: components['schemas']['microsoft.graph.itemAnalytics'] | (Record<string, never> | null);
+    children?: components['schemas']['microsoft.graph.driveItem'][];
+    listItem?: components['schemas']['microsoft.graph.listItem'] | (Record<string, never> | null);
+    permissions?: components['schemas']['microsoft.graph.permission'][];
+    retentionLabel?: components['schemas']['microsoft.graph.itemRetentionLabel'] | (Record<string, never> | null);
+    subscriptions?: components['schemas']['microsoft.graph.subscription'][];
+    thumbnails?: components['schemas']['microsoft.graph.thumbnailSet'][];
+    versions?: components['schemas']['microsoft.graph.driveItemVersion'][];
+    workbook?: components['schemas']['microsoft.graph.workbook'] | (Record<string, never> | null);
+    '@odata.type': string;
+  }>;
+};
+//#endregion
+//#region src/clients/microsoftGraph/middleware.d.ts
+/**
+ * Stamps a Graph access token as `Authorization: Bearer …`.
+ *
+ * There is deliberately no refresh-and-replay here, and no `sdks/microsoftGraph/` to own one: the
+ * consumer's OAuth library (MSAL in the browser) mints and refreshes these tokens per user
+ * interaction, so this package holds no token state to manage. It exists so the client can take a
+ * `MiddlewareFn` rather than a credential, without every consumer restating the header.
+ */
+declare const createMicrosoftGraphAuthMiddleware: (accessToken: string) => MiddlewareFn;
+//#endregion
+export { createMicrosoftGraphAuthMiddleware, createMicrosoftGraphClient };
+//# sourceMappingURL=index.d.cts.map