@vibesdotdev/integrations-microsoft 0.0.0-stage → 1.0.0-rc.0

package/dist/email/microsoft/outlook.mime.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Outlook / Graph mail address + inbound mapping helpers. Universal-scope.
+ */
+export declare const MAX_BODY_CHARS = 200000;
+export declare const MAX_ATTACHMENT_BYTES: number;
+import type { GraphRecipient, Mailbox } from '../../schemas/outlook.ts';
+export type { GraphRecipient, GraphMessage, GraphFileAttachment } from '../../schemas/outlook.ts';
+export declare function mailboxAddress(value: string): string;
+export declare function splitMailbox(mailbox: string): Mailbox;
+export declare function addressesEqual(left: string, right: string): boolean;
+export declare function cap(value: string, max?: number): string;
+export declare function formatRecipient(recipient: GraphRecipient | undefined): string;
+export declare function recipientAddresses(recipients: GraphRecipient[] | undefined): string[];
+export declare function toGraphRecipients(values: string[] | undefined): GraphRecipient[];
+export declare function stripAngleBrackets(value: string): string;
+export declare function bytesToBase64(bytes: Uint8Array): string;
+export declare function decodeBase64ToBytes(data: string): Uint8Array;
+//# sourceMappingURL=outlook.mime.d.ts.map

package/dist/email/microsoft/outlook.mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outlook.mime.d.ts","sourceRoot":"","sources":["../../../src/email/microsoft/outlook.mime.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,cAAc,SAAQ,CAAC;AACpC,eAAO,MAAM,oBAAoB,QAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,cAAc,EAAC,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACvE,YAAY,EAAE,cAAc,EAAC,YAAY,EAAC,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEhG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGpD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAQrD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAElE;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAC,GAAG,SAAe,GAAG,MAAM,CAE5D;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,cAAc,GAAC,SAAS,GAAG,MAAM,CAK3E;AAED,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,cAAc,EAAE,GAAC,SAAS,GAAG,MAAM,EAAE,CAInF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAC,SAAS,GAAG,cAAc,EAAE,CAK9E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAMvD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAK5D"}

package/dist/email/microsoft/outlook.mime.js

@@ -0,0 +1,61 @@
+/**
+ * Outlook / Graph mail address + inbound mapping helpers. Universal-scope.
+ */
+export const MAX_BODY_CHARS = 200_000;
+export const MAX_ATTACHMENT_BYTES = 25 * 1024 * 1024;
+export function mailboxAddress(value) {
+    const match = value.match(/<([^>]+)>/);
+    return (match ? match[1] : value).trim().toLowerCase();
+}
+export function splitMailbox(mailbox) {
+    const match = mailbox.match(/^\s*(?:"?([^"<]+?)"?\s+)?<([^>]+)>\s*$/);
+    if (match) {
+        const parsed = { addr: match[2].trim() };
+        if (match[1])
+            parsed.name = match[1].trim();
+        return parsed;
+    }
+    return { addr: mailbox.trim() };
+}
+export function addressesEqual(left, right) {
+    return mailboxAddress(left) === mailboxAddress(right);
+}
+export function cap(value, max = MAX_BODY_CHARS) {
+    return value.length <= max ? value : value.slice(0, max);
+}
+export function formatRecipient(recipient) {
+    const address = recipient?.emailAddress?.address ?? '';
+    const name = recipient?.emailAddress?.name ?? '';
+    if (name && address)
+        return `${name} <${address}>`;
+    return address;
+}
+export function recipientAddresses(recipients) {
+    return (recipients ?? [])
+        .map((recipient) => recipient.emailAddress?.address?.trim() ?? '')
+        .filter(Boolean);
+}
+export function toGraphRecipients(values) {
+    return (values ?? []).map((value) => {
+        const { addr, name } = splitMailbox(value);
+        return { emailAddress: { address: addr, name } };
+    });
+}
+export function stripAngleBrackets(value) {
+    return value.replace(/^<|>$/g, '').trim();
+}
+export function bytesToBase64(bytes) {
+    let binary = '';
+    for (let offset = 0; offset < bytes.length; offset += 8192) {
+        binary += String.fromCharCode(...bytes.subarray(offset, offset + 8192));
+    }
+    return btoa(binary);
+}
+export function decodeBase64ToBytes(data) {
+    const binary = atob(data);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++)
+        bytes[i] = binary.charCodeAt(i);
+    return bytes;
+}
+//# sourceMappingURL=outlook.mime.js.map

package/dist/email/microsoft/outlook.mime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outlook.mime.js","sourceRoot":"","sources":["../../../src/email/microsoft/outlook.mime.ts"],"names":[],"mappings":"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"}

package/dist/email/microsoft-email.plugin.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Runtime plugin for the Outlook mail feature pack.
+ *
+ * Registers the `integration/provider` (`integration.email.microsoft`) plus
+ * the dual-registered `email/transport` adapter. Lives on the existing
+ * Microsoft vendor package — not a new host or SKU.
+ */
+export declare const microsoftEmailPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default microsoftEmailPlugin;
+//# sourceMappingURL=microsoft-email.plugin.d.ts.map

package/dist/email/microsoft-email.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"microsoft-email.plugin.d.ts","sourceRoot":"","sources":["../../src/email/microsoft-email.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,eAAO,MAAM,oBAAoB,6CAgB/B,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/email/microsoft-email.plugin.js

@@ -0,0 +1,29 @@
+/**
+ * Runtime plugin for the Outlook mail feature pack.
+ *
+ * Registers the `integration/provider` (`integration.email.microsoft`) plus
+ * the dual-registered `email/transport` adapter. Lives on the existing
+ * Microsoft vendor package — not a new host or SKU.
+ */
+import { createRuntimePlugin, loader } from '@vibesdotdev/kernel/factory';
+import { IntegrationBackedEmailTransport, createIntegrationBackedEmailTransportDescriptor } from '@vibesdotdev/email/services/email-transport';
+import outlookMailDescriptor from "./microsoft/microsoft.descriptor.js";
+const outlookTransportDescriptor = createIntegrationBackedEmailTransportDescriptor(outlookMailDescriptor);
+export const microsoftEmailPlugin = createRuntimePlugin({
+    id: 'integrations-microsoft/email',
+    name: 'Outlook Mail Integration',
+    description: 'Microsoft Graph mail feature on the existing Microsoft 365 integration: send, check, and pull-mode receive.',
+    dependencies: ['integrations', 'email'],
+    descriptors: [outlookMailDescriptor, outlookTransportDescriptor],
+    loaders: [
+        loader(outlookMailDescriptor.id, { kind: 'integration/provider' }, async () => {
+            const { OutlookMailIntegration } = await import("./microsoft/microsoft.impl.js");
+            return { default: OutlookMailIntegration };
+        }),
+        loader(outlookTransportDescriptor.id, { kind: 'email/transport' }, async () => ({
+            default: IntegrationBackedEmailTransport
+        }))
+    ]
+});
+export default microsoftEmailPlugin;
+//# sourceMappingURL=microsoft-email.plugin.js.map

package/dist/email/microsoft-email.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"microsoft-email.plugin.js","sourceRoot":"","sources":["../../src/email/microsoft-email.plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAC1E,OAAO,EACN,+BAA+B,EAC/B,+CAA+C,EAC/C,MAAM,6CAA6C,CAAC;AACrD,OAAO,qBAAqB,MAAM,qCAAqC,CAAC;AAExE,MAAM,0BAA0B,GAAG,+CAA+C,CAAC,qBAAqB,CAAC,CAAC;AAE1G,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;IACvD,EAAE,EAAE,8BAA8B;IAClC,IAAI,EAAE,0BAA0B;IAChC,WAAW,EACV,6GAA6G;IAC9G,YAAY,EAAE,CAAC,cAAc,EAAE,OAAO,CAAC;IACvC,WAAW,EAAE,CAAC,qBAAqB,EAAE,0BAA0B,CAAC;IAChE,OAAO,EAAE;QACR,MAAM,CAAC,qBAAqB,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,sBAAsB,EAAE,EAAE,KAAK,IAAI,EAAE;YAC7E,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;YACjF,OAAO,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;QAC5C,CAAC,CAAC;QACF,MAAM,CAAC,0BAA0B,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YAC/E,OAAO,EAAE,+BAA+B;SACxC,CAAC,CAAC;KACH;CACD,CAAC,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/** Isomorphic Microsoft 365 client and contracts. Full Node composition lives at ./plugin. */
+export { microsoftClientPlugin, microsoftClientPlugin as default } from './api-client-plugin.ts';
+export { MicrosoftClient, getVibesMicrosoftClient } from './client/index.ts';
+export type { MicrosoftClientMode } from './schemas/operations.ts';
+export * from './schemas/graph.ts';
+export { default as microsoftDescriptor } from './microsoft/system.integration.microsoft.descriptor.ts';
+export { default as microsoftDelegatedDescriptor } from './microsoft/system.integration.microsoft.delegated.descriptor.ts';
+export { microsoftEmailPlugin } from './email/microsoft-email.plugin.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EAAE,qBAAqB,EAAC,qBAAqB,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,eAAe,EAAC,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,YAAY,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AACxG,OAAO,EAAE,OAAO,IAAI,4BAA4B,EAAE,MAAM,kEAAkE,CAAC;AAC3H,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/** Isomorphic Microsoft 365 client and contracts. Full Node composition lives at ./plugin. */
+export { microsoftClientPlugin, microsoftClientPlugin as default } from "./api-client-plugin.js";
+export { MicrosoftClient, getVibesMicrosoftClient } from "./client/index.js";
+export * from "./schemas/graph.js";
+export { default as microsoftDescriptor } from "./microsoft/system.integration.microsoft.descriptor.js";
+export { default as microsoftDelegatedDescriptor } from "./microsoft/system.integration.microsoft.delegated.descriptor.js";
+export { microsoftEmailPlugin } from "./email/microsoft-email.plugin.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,OAAO,EAAE,qBAAqB,EAAC,qBAAqB,IAAI,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,eAAe,EAAC,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AACxG,OAAO,EAAE,OAAO,IAAI,4BAA4B,EAAE,MAAM,kEAAkE,CAAC;AAC3H,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/integrations-microsoft.plugin.d.ts

@@ -0,0 +1,4 @@
+/** Compatibility composition for Node hosts. Browser/Worker hosts compose the explicit narrow slices. */
+export declare const integrationsMicrosoftPlugin: import("@vibesdotdev/kernel").RuntimePlugin;
+export default integrationsMicrosoftPlugin;
+//# sourceMappingURL=integrations-microsoft.plugin.d.ts.map

package/dist/integrations-microsoft.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations-microsoft.plugin.d.ts","sourceRoot":"","sources":["../src/integrations-microsoft.plugin.ts"],"names":[],"mappings":"AAIA,yGAAyG;AACzG,eAAO,MAAM,2BAA2B,6CAOtC,CAAC;AACH,eAAe,2BAA2B,CAAC"}

package/dist/integrations-microsoft.plugin.js

@@ -0,0 +1,15 @@
+import { createRuntimePlugin } from '@vibesdotdev/kernel/factory';
+import client from "./api-client-plugin.js";
+import cloud from "./cloud.plugin.js";
+import consumer from "./microsoft.consumer.plugin.js";
+/** Compatibility composition for Node hosts. Browser/Worker hosts compose the explicit narrow slices. */
+export const integrationsMicrosoftPlugin = createRuntimePlugin({
+    id: 'integrations-microsoft', name: 'Microsoft 365',
+    async onRegister(runtime) {
+        await client.onRegister?.(runtime);
+        await cloud.onRegister?.(runtime);
+        await consumer.onRegister?.(runtime);
+    }
+});
+export default integrationsMicrosoftPlugin;
+//# sourceMappingURL=integrations-microsoft.plugin.js.map

package/dist/integrations-microsoft.plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrations-microsoft.plugin.js","sourceRoot":"","sources":["../src/integrations-microsoft.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,MAAM,MAAM,wBAAwB,CAAC;AAC5C,OAAO,KAAK,MAAM,mBAAmB,CAAC;AACtC,OAAO,QAAQ,MAAM,gCAAgC,CAAC;AACtD,yGAAyG;AACzG,MAAM,CAAC,MAAM,2BAA2B,GAAC,mBAAmB,CAAC;IAC5D,EAAE,EAAE,wBAAwB,EAAC,IAAI,EAAE,eAAe;IAClD,KAAK,CAAC,UAAU,CAAC,OAAO;QACvB,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;QACnC,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;CACD,CAAC,CAAC;AACH,eAAe,2BAA2B,CAAC"}

package/dist/microsoft/graph-drive-fallback.d.ts

@@ -0,0 +1,11 @@
+import type { DriveItemEntry, DriveItemSearchResult } from './graph-schemas.ts';
+import type { GraphSharePointClient } from './graph-sharepoint-client.ts';
+export declare function normalizeGraphDrivePath(path: string): string;
+export declare function isGraphPathAddressingFailure(err: unknown): boolean;
+export declare function browseDriveWithPathFallback(client: GraphSharePointClient, siteId: string, folderPath?: string): Promise<DriveItemEntry[]>;
+export declare function searchDriveWithPathFallback(client: GraphSharePointClient, siteId: string, query: string, opts?: {
+    scopePath?: string;
+    limit?: number;
+}): Promise<DriveItemSearchResult[]>;
+export declare function resolveFolderItemId(client: GraphSharePointClient, siteId: string, folderPath: string): Promise<string | null>;
+//# sourceMappingURL=graph-drive-fallback.d.ts.map

package/dist/microsoft/graph-drive-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-drive-fallback.d.ts","sourceRoot":"","sources":["../../src/microsoft/graph-drive-fallback.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAC,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAE1E,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5D;AA0BD,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAIlE;AAED,wBAAsB,2BAA2B,CAChD,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,EAAE,CAAC,CAO3B;AAED,wBAAsB,2BAA2B,CAChD,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CAAE,GAC5C,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAelC;AAED,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,GAAC,IAAI,CAAC,CAwBtB"}

package/dist/microsoft/graph-drive-fallback.js

@@ -0,0 +1,90 @@
+import { CaughtFailureSchema, settle } from '@vibesdotdev/kernel';
+import { MicrosoftGraphError } from "../schemas/boundary.js";
+export function normalizeGraphDrivePath(path) {
+    return path
+        .split('/')
+        .map((segment) => segment.trim())
+        .filter((segment) => segment.length > 0)
+        .join('/');
+}
+function splitPathLikeSearchQuery(query) {
+    const normalized = normalizeGraphDrivePath(query);
+    if (!normalized.includes('/'))
+        return null;
+    const segments = normalized.split('/');
+    const leaf = segments.at(-1);
+    if (!leaf)
+        return null;
+    const scopePath = segments.slice(0, -1).join('/');
+    if (!scopePath)
+        return null;
+    return { scopePath, query: leaf };
+}
+function filterSearchHitsToScope(hits, scopePath, limit) {
+    const normalizedScope = normalizeGraphDrivePath(scopePath);
+    const scoped = hits.filter((hit) => {
+        const parentPath = normalizeGraphDrivePath(hit.parentPath);
+        return parentPath === normalizedScope || parentPath.startsWith(`${normalizedScope}/`);
+    });
+    return scoped.slice(0, limit ?? 50);
+}
+export function isGraphPathAddressingFailure(err) {
+    const failure = CaughtFailureSchema.parse(err);
+    return failure instanceof MicrosoftGraphError && (failure.status === 500 ||
+        (failure.status === 404 && (failure.graphCode === 'itemNotFound' || failure.graphCode === 'ResourceNotFound')));
+}
+export async function browseDriveWithPathFallback(client, siteId, folderPath) {
+    const attempt = await settle(() => client.browseDrive(siteId, folderPath));
+    if (attempt.ok)
+        return attempt.value;
+    if (!folderPath || !isGraphPathAddressingFailure(attempt.cause))
+        throw attempt.cause;
+    const folderId = await resolveFolderItemId(client, siteId, folderPath);
+    if (!folderId)
+        throw attempt.cause;
+    return client.browseDriveItem(siteId, folderId);
+}
+export async function searchDriveWithPathFallback(client, siteId, query, opts) {
+    const pathLikeQuery = opts?.scopePath ? null : splitPathLikeSearchQuery(query);
+    if (pathLikeQuery) {
+        return searchDriveWithPathFallback(client, siteId, pathLikeQuery.query, {
+            scopePath: pathLikeQuery.scopePath,
+            limit: opts?.limit
+        });
+    }
+    const attempt = await settle(() => client.searchDrive(siteId, query, {
+        scopePath: opts?.scopePath, limit: opts?.limit
+    }));
+    if (!attempt.ok && (!opts?.scopePath || !isGraphPathAddressingFailure(attempt.cause)))
+        throw attempt.cause;
+    if (attempt.ok && (!opts?.scopePath || attempt.value.length > 0))
+        return attempt.value;
+    const fallback = await client.searchDrive(siteId, query, { limit: 200 });
+    return opts?.scopePath ? filterSearchHitsToScope(fallback, opts.scopePath, opts.limit) : fallback;
+}
+export async function resolveFolderItemId(client, siteId, folderPath) {
+    const normalized = normalizeGraphDrivePath(folderPath);
+    if (!normalized)
+        return null;
+    const segments = normalized.split('/');
+    const folderName = segments.at(-1);
+    if (!folderName)
+        return null;
+    const parentPath = segments.slice(0, -1).join('/');
+    const attempt = await settle(() => client.searchDrive(siteId, folderName, {
+        scopePath: parentPath || undefined, limit: 25
+    }));
+    if (!attempt.ok && !isGraphPathAddressingFailure(attempt.cause))
+        throw attempt.cause;
+    const hits = !attempt.ok || (parentPath && !attempt.value.some(hit => hit.isFolder))
+        ? await client.searchDrive(siteId, folderName, { limit: 100 })
+        : attempt.value;
+    const match = hits.find((hit) => {
+        if (!hit.isFolder)
+            return false;
+        return (normalizeGraphDrivePath(`${hit.parentPath ? `${hit.parentPath}/` : ''}${hit.name}`) ===
+            normalized);
+    });
+    return match?.id ?? null;
+}
+//# sourceMappingURL=graph-drive-fallback.js.map

package/dist/microsoft/graph-drive-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-drive-fallback.js","sourceRoot":"","sources":["../../src/microsoft/graph-drive-fallback.ts"],"names":[],"mappings":"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"}

package/dist/microsoft/graph-schemas.d.ts

@@ -0,0 +1,2 @@
+export * from '../schemas/graph.ts';
+//# sourceMappingURL=graph-schemas.d.ts.map

package/dist/microsoft/graph-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-schemas.d.ts","sourceRoot":"","sources":["../../src/microsoft/graph-schemas.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/microsoft/graph-schemas.js

@@ -0,0 +1,2 @@
+export * from "../schemas/graph.js";
+//# sourceMappingURL=graph-schemas.js.map

package/dist/microsoft/graph-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-schemas.js","sourceRoot":"","sources":["../../src/microsoft/graph-schemas.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC"}

package/dist/microsoft/graph-sharepoint-client.d.ts

@@ -0,0 +1,219 @@
+import { type SharePointSite, type GraphDrive, type DriveItemEntry, type DriveItemSearchResult } from './graph-schemas.ts';
+import type { MicrosoftFetch } from './secrets-fetch.ts';
+/**
+ * Sentinel "site id" that targets the signed-in user's personal OneDrive
+ * (`/me/drive`) instead of a SharePoint site. Delegated only — app-only tokens
+ * have no `/me`. Used as a drive id by the explorer for the "OneDrive" entry.
+ */
+export declare const ONEDRIVE_SITE_ID = "me";
+/**
+ * Legacy direct-call token acquirer. Registered providers use the
+ * Secrets-owned `authenticatedFetch` transport instead.
+ */
+export interface MicrosoftTokenAcquirer {
+    acquireToken(scopes?: string[]): Promise<{
+        accessToken: string;
+    }>;
+}
+export interface GraphClientConfig {
+    /** Legacy token acquirer for direct callers; providers use authenticatedFetch. */
+    integration?: MicrosoftTokenAcquirer;
+    /** Secrets-owned authenticated transport. */
+    authenticatedFetch?: MicrosoftFetch;
+    /** Unauthenticated far-boundary fetch, including pre-authenticated upload sessions. */
+    fetchFn?: MicrosoftFetch;
+}
+/**
+ * Microsoft Graph API client for SharePoint operations.
+ *
+ * Provides listSites(), browseDrive(), and downloadFile() methods.
+ * Uses the runtime-supplied authenticated transport for registered
+ * providers. App-only access requires the Sites.Read.All (read) /
+ * Sites.ReadWrite.All (write) + Files.Read.All/Files.ReadWrite.All APPLICATION
+ * permissions, admin-consented into the org's tenant — Sites.Selected does NOT
+ * satisfy the `GET /sites?search=*` site enumeration listSites() relies on.
+ */
+export declare class GraphSharePointClient {
+    private readonly integration;
+    private readonly authenticatedFetch;
+    private readonly fetchFn;
+    constructor(config: GraphClientConfig);
+    /**
+     * Build a download URL operation result without streaming binary
+     * content through the dispatch path. Calls
+     * `/sites/{site-id}/drive/items/{item-id}` with `?$select=id,@microsoft.graph.downloadUrl`
+     * and returns the temporary URL Graph mints (~1h validity). Consumers
+     * fetch bytes directly; this keeps the JSON-only operations dispatch
+     * binary-free.
+     */
+    getDownloadUrl(siteId: string, itemId: string): Promise<{
+        url: string;
+        expiresAt: string | null;
+    }>;
+    /**
+     * Pre-authenticated download URL for a drive item addressed by its PATH (vs
+     * item id). Returns Graph's `@microsoft.graph.downloadUrl` — a short-lived
+     * Azure Blob SAS URL that needs no auth header, so it works directly in a
+     * browser `<img>`/`<iframe>`/download across origins (the object store has no
+     * stable anonymous URL otherwise). `null` if the item is missing.
+     */
+    getDownloadUrlByPath(siteId: string, path: string): Promise<string | null>;
+    /**
+     * List SharePoint sites the app has access to.
+     *
+     * Returns normalized site objects with id, name, and webUrl.
+     * App-only requires the Sites.Read.All application permission so the
+     * `GET /sites?search=*` enumeration returns the tenant's sites.
+     *
+     * GET /sites?search=*&$select=id,name,webUrl,displayName
+     *
+     * @returns Array of SharePoint sites
+     */
+    listSites(): Promise<SharePointSite[]>;
+    /**
+     * Return a site's default document library as a real Graph drive.
+     *
+     * Storage consumers pass a `driveId`, not a site id. SharePoint site ids are
+     * often composite strings (`host,siteCollectionId,webId`) that are brittle in
+     * agent/tool contexts, while Graph drive ids are the stable primitive accepted
+     * by `/drives/{id}` across browse/search/download operations.
+     */
+    getDefaultDrive(siteId: string): Promise<GraphDrive>;
+    /**
+     * Browse folder contents within a SharePoint site's default drive.
+     *
+     * GET /sites/{site-id}/drive/root/children
+     *
+     * When folderPath is provided:
+     * GET /sites/{site-id}/drive/root:/{folderPath}:/children
+     *
+     * @param siteId - SharePoint site ID
+     * @param folderPath - Optional path relative to drive root (e.g. "Documents/Reports")
+     * @returns Array of drive item entries (files and folders)
+     */
+    browseDrive(siteId: string, folderPath?: string): Promise<DriveItemEntry[]>;
+    /**
+     * Browse folder contents by stable DriveItem id.
+     *
+     * Use this when a caller already has an item id from search/list, or when
+     * Graph path addressing rejects an otherwise valid folder path.
+     */
+    browseDriveItem(siteId: string, itemId: string): Promise<DriveItemEntry[]>;
+    /**
+     * RECURSIVELY search a site/OneDrive drive for items matching `query`,
+     * at ANY depth, in a single Graph call.
+     *
+     * Uses Graph's server-side drive search:
+     *   GET /sites/{site-id}/drive/root/search(q='{query}')
+     *   GET /me/drive/root/search(q='{query}')           (OneDrive sentinel)
+     *
+     * Graph indexes the whole drive server-side and matches on file/folder
+     * NAME and (for supported types) CONTENT — so a partial job number or
+     * filename matches files buried several folders deep (e.g. a PDF under
+     * "Projects to Bid/2026/Acme/Drawings") that the one-level {@link browseDrive}
+     * can never reach. `$select` includes `parentReference` so each hit carries
+     * its folder path for breadcrumbs / relinking.
+     *
+     * `scopePath` (optional, drive-root-relative) narrows the search to a
+     * subtree by addressing the folder before `:/search` — e.g.
+     *   GET /sites/{id}/drive/root:/Projects to Bid:/search(q='...')
+     * Use it to keep results inside the org's bid folder.
+     *
+     * @param siteId    SharePoint site id, or {@link ONEDRIVE_SITE_ID} for OneDrive
+     * @param query     free-text query (job number, partial filename, content)
+     * @param opts.scopePath  optional folder subtree to search within
+     * @param opts.limit      cap on hits returned (default 25); paging stops early
+     * @returns Array of search hits with folder path metadata
+     */
+    searchDrive(siteId: string, query: string, opts?: {
+        scopePath?: string;
+        limit?: number;
+    }): Promise<DriveItemSearchResult[]>;
+    /**
+     * Download file content from a SharePoint drive.
+     *
+     * Read Graph's item metadata, then fetch its preauthenticated download URL
+     * without forwarding Graph authorization across origins.
+     *
+     * Returns the raw binary content as a Blob.
+     * Callers can convert to ArrayBuffer, ReadableStream, or base64
+     * depending on their needs.
+     *
+     * @param siteId - SharePoint site ID
+     * @param itemId - Drive item ID (file)
+     * @returns Blob with file content
+     */
+    downloadFile(siteId: string, itemId: string): Promise<Blob>;
+    /**
+     * Upload bytes to `path` (relative to the site drive root), creating or
+     * overwriting the file. Simple PUT below ~4 MiB; resumable upload session
+     * (chunked) at or above it.
+     */
+    uploadFile(siteId: string, path: string, body: ArrayBuffer | ReadableStream | Blob, opts?: {
+        contentType?: string;
+        conflictBehavior?: 'replace' | 'rename' | 'fail';
+    }): Promise<DriveItemEntry>;
+    private simpleUpload;
+    private resumableUpload;
+    /**
+     * Create a folder named `name` under `parentPath` (drive-root-relative; empty
+     * for the root). `conflictBehavior` defaults to `fail` so existing folders
+     * are not clobbered.
+     */
+    createFolder(siteId: string, parentPath: string, name: string, conflictBehavior?: 'replace' | 'rename' | 'fail'): Promise<DriveItemEntry>;
+    /** Delete a drive item by its id. */
+    deleteItem(siteId: string, itemId: string): Promise<void>;
+    /** Delete a drive item by its drive-root-relative path. */
+    deletePath(siteId: string, path: string): Promise<void>;
+    /** Fetch metadata for the item at `path`, or `null` if it does not exist. */
+    headPath(siteId: string, path: string): Promise<{
+        id: string;
+        size: number;
+        mimeType: string;
+        lastModified: string;
+        webUrl?: string;
+    } | null>;
+    /** Stream the bytes of the item at `path`, or `null` if it does not exist. */
+    getStream(siteId: string, path: string): Promise<ReadableStream<Uint8Array> | null>;
+    /** Metadata URLs and Graph's proxy fallback both leave credentials at Graph. */
+    private downloadResponse;
+    private downloadTarget;
+    private executeWriteJson;
+    private executeDelete;
+    /** Retrieve a token only for legacy direct callers; registered providers use Secrets. */
+    private acquireAccessToken;
+    /**
+     * Graph drive base for the storage drive identifier. The sentinel
+     * {@link ONEDRIVE_SITE_ID} (`'me'`) targets the signed-in user's personal
+     * OneDrive (`/me/drive`, delegated only). Composite SharePoint site ids keep
+     * using `/sites/{id}/drive` for backwards compatibility; real Graph drive ids
+     * use `/drives/{id}`.
+     */
+    private driveRoot;
+    /**
+     * Execute a JSON-bearing Graph API request with auth header.
+     */
+    private executeRequest;
+    /** All Graph transports preserve typed, value-safe failures. */
+    private fetchResponse;
+    private admitGraphResponse;
+    private readGraphResponse;
+    /**
+     * Follow @odata.nextLink for paginated responses.
+     */
+    private fetchAllPages;
+    /**
+     * Normalize a raw Graph DriveItem into our simplified DriveItemEntry.
+     */
+    private normalizeDriveItem;
+    /**
+     * Normalize a raw Graph search-hit DriveItem into a DriveItemSearchResult,
+     * deriving the drive-root-relative `parentPath` from `parentReference.path`.
+     *
+     * Graph's `parentReference.path` looks like `/drive/root:/Projects to Bid/2026`
+     * (URL-encoded segments). We strip the `/drive/root:` (or `/drives/{id}/root:`)
+     * prefix and decode each segment so consumers get `Projects to Bid/2026`.
+     */
+    private normalizeSearchResult;
+}
+//# sourceMappingURL=graph-sharepoint-client.d.ts.map

package/dist/microsoft/graph-sharepoint-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-sharepoint-client.d.ts","sourceRoot":"","sources":["../../src/microsoft/graph-sharepoint-client.ts"],"names":[],"mappings":"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"}