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

package/dist/schemas/sharepoint.js

@@ -0,0 +1,71 @@
+/**
+ * SharePoint Storage Adapter Schemas
+ *
+ * Zod schemas for document records and configuration
+ * used by the SharePoint storage adapter.
+ */
+import * as z from 'zod/v4';
+// Document Record
+/**
+ * A document record stored in SharePoint.
+ *
+ * Normalized from Graph API DriveItem responses to
+ * provide a consistent document interface.
+ */
+export const SharePointDocumentRecordSchema = z.object({
+    /** Unique item ID from Graph API (drive item ID) */
+    id: z.string(),
+    /** Document file name */
+    name: z.string(),
+    /** File size in bytes */
+    size: z.number(),
+    /** Last modified timestamp (ISO 8601) */
+    modifiedAt: z.string(),
+    /** MIME type of the document */
+    mimeType: z.string().default('application/octet-stream'),
+    /** SharePoint web URL for the document */
+    webUrl: z.string().optional(),
+    /** Parent container ID (drive/folder ID) */
+    containerId: z.string().default('')
+});
+/**
+ * Metadata provided when uploading a document.
+ */
+export const SharePointUploadMetadataSchema = z.object({
+    /** File name for the upload */
+    name: z.string().min(1),
+    /** Optional content type override */
+    contentType: z.string().optional(),
+    /** Optional conflict behavior: 'fail' | 'replace' | 'rename' */
+    conflictBehavior: z.enum(['fail', 'replace', 'rename']).default('replace')
+});
+/**
+ * List options for querying documents in a container.
+ */
+export const SharePointListOptionsSchema = z.object({
+    /** Filter by file extension (e.g. '.pdf') */
+    extension: z.string().optional(),
+    /** Whether to include folders in results */
+    includeFolders: z.boolean().default(false),
+    /** Maximum items to return */
+    limit: z.number().min(1).max(200).default(100)
+});
+// Configuration
+/**
+ * Configuration for the SharePoint storage adapter.
+ *
+ * The adapter needs a GraphSharePointClient to communicate
+ * with Microsoft Graph API, and optionally a default site ID
+ * and drive ID for operations that don't specify a container.
+ */
+export const SharePointAdapterConfigSchema = z.object({
+    /** Default SharePoint site ID for operations without explicit containerId */
+    siteId: z.string().optional(),
+    /** Default drive ID within the site */
+    driveId: z.string().optional(),
+    basePath: z.string().optional(),
+    integrationId: z.string().default('integration.microsoft')
+});
+export const SharePointFolderManifestSchema = z.string().optional();
+export const SharePointAdapterOverrideSchema = SharePointAdapterConfigSchema.partial();
+//# sourceMappingURL=sharepoint.js.map

package/dist/schemas/sharepoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharepoint.js","sourceRoot":"","sources":["../../src/schemas/sharepoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,kBAAkB;AAElB;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAC,CAAC,CAAC,MAAM,CAAC;IACpD,oDAAoD;IACpD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,yBAAyB;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,yBAAyB;IACzB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,yCAAyC;IACzC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,gCAAgC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,0BAA0B,CAAC;IACxD,0CAA0C;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,4CAA4C;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;CACnC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAC,CAAC,CAAC,MAAM,CAAC;IACpD,+BAA+B;IAC/B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,qCAAqC;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,gEAAgE;IAChE,gBAAgB,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAC,SAAS,EAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC;CACxE,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAC,CAAC,CAAC,MAAM,CAAC;IACjD,6CAA6C;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,4CAA4C;IAC5C,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC1C,8BAA8B;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC;CAC9C,CAAC,CAAC;AAIH,gBAAgB;AAEhB;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAC,CAAC,CAAC,MAAM,CAAC;IACnD,6EAA6E;IAC7E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,uCAAuC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,uBAAuB,CAAC;CAC1D,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,8BAA8B,GAAC,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC;AAElE,MAAM,CAAC,MAAM,+BAA+B,GAAC,6BAA6B,CAAC,OAAO,EAAE,CAAC"}

package/dist/server/oauth.d.ts

@@ -0,0 +1,9 @@
+import { type MicrosoftExchangeParams, type MicrosoftTokenResponse, type MicrosoftTokenStoreInput, type OAuthSecretService, type OAuthSecretServiceContext } from '../schemas/oauth.ts';
+export type { OAuthSecretMetadataValue, OAuthSecretServiceContext, OAuthSecretService, MicrosoftTokenResponse, OAuthMicrosoftResult, MicrosoftExchangeParams } from '../schemas/oauth.ts';
+export declare function exchangeMicrosoftCodeForTokens(input: MicrosoftExchangeParams): Promise<MicrosoftTokenResponse>;
+/** Update existing owner records in place. An omitted refresh token never retires a recoverable credential. */
+export declare function storeMicrosoftTokens(params: MicrosoftTokenStoreInput & {
+    service: OAuthSecretService;
+    context: OAuthSecretServiceContext;
+}): Promise<void>;
+//# sourceMappingURL=oauth.d.ts.map

package/dist/server/oauth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../../src/server/oauth.ts"],"names":[],"mappings":"AAGA,OAAO,EAEN,KAAK,uBAAuB,EAAC,KAAK,sBAAsB,EAAC,KAAK,wBAAwB,EAAC,KAAK,kBAAkB,EAAC,KAAK,yBAAyB,EAC7I,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,wBAAwB,EAAC,yBAAyB,EAAC,kBAAkB,EAAC,sBAAsB,EAAC,oBAAoB,EAAC,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAErL,wBAAsB,8BAA8B,CAAC,KAAK,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA0BpH;AAED,+GAA+G;AAC/G,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,wBAAwB,GAAC;IAAE,OAAO,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,yBAAyB,CAAC;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyB/J"}

package/dist/server/oauth.js

@@ -0,0 +1,67 @@
+import { CaughtFailureSchema, valueFreeFailure, settle } from '@vibesdotdev/kernel';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { admitMicrosoft } from "../schemas/boundary.js";
+import { OAuthSecretRecordSchema, MicrosoftExchangeParamsSchema, MicrosoftTokenResponseSchema, MicrosoftTokenStoreInputSchema, OAuthSecretServiceContextSchema } from "../schemas/oauth.js";
+export async function exchangeMicrosoftCodeForTokens(input) {
+    const params = admitMicrosoft(MicrosoftExchangeParamsSchema, input);
+    let response;
+    try {
+        response = await fetch(`https://login.microsoftonline.com/${encodeURIComponent(params.tenantId)}/oauth2/v2.0/token`, {
+            method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded', Accept: 'application/json' },
+            body: new URLSearchParams({
+                grant_type: 'authorization_code', code: params.code, redirect_uri: params.redirectUri,
+                client_id: params.clientId, client_secret: params.clientSecret, scope: (params.scopes ?? ['https://graph.microsoft.com/.default']).join(' ')
+            })
+        });
+    }
+    catch (error) {
+        const failure = CaughtFailureSchema.parse(error);
+        if (failure instanceof CapabilityError)
+            throw failure;
+        throw new CapabilityError('Microsoft request failed.', 'UNAVAILABLE', {
+            reason: 'microsoft-request-failed', cause: failure, details: { failure: valueFreeFailure(failure) }
+        });
+    }
+    if (!response.ok)
+        throw new CapabilityError('Microsoft token exchange was refused.', 'AUTH_REQUIRED', {
+            reason: 'microsoft-oauth-exchange-refused', details: { status: response.status }
+        });
+    const decoded = await settle(() => response.json());
+    if (!decoded.ok)
+        throw new CapabilityError('Microsoft token endpoint returned invalid JSON.', 'UNAVAILABLE', {
+            reason: 'microsoft-oauth-response-invalid', details: { failure: valueFreeFailure(decoded.cause) }
+        });
+    return admitMicrosoft(MicrosoftTokenResponseSchema, decoded.value, 'response');
+}
+/** Update existing owner records in place. An omitted refresh token never retires a recoverable credential. */
+export async function storeMicrosoftTokens(params) {
+    const input = admitMicrosoft(MicrosoftTokenStoreInputSchema, params);
+    const context = admitMicrosoft(OAuthSecretServiceContextSchema, params.context);
+    const tokens = [{ name: 'accessToken', value: input.accessToken, expiresIn: input.expiresIn }];
+    const refresh = input.refreshToken;
+    const write = async (name, value, expiresIn) => {
+        const query = { name, scope: 'org', scopeId: input.scopeId, providerType: 'microsoft' };
+        const metadata = {
+            integration: 'microsoft', tenantId: input.tenantId,
+            expiresAt: expiresIn === undefined ? null : new Date(Date.now() + expiresIn * 1000).toISOString(),
+            tokenType: name === 'accessToken' ? 'access' : 'refresh'
+        };
+        const records = admitMicrosoft(OAuthSecretRecordSchema.array(), await params.service.list(query, context));
+        // The secret owner's list filters scope/provider; name is filtered here against its record contract.
+        const existing = records.filter(record => record.name === query.name && record.scope === query.scope &&
+            record.scopeId === query.scopeId && record.providerType === query.providerType);
+        if (existing.length > 0) {
+            // Replace all readable matches: historical duplicates must not retain a stale token.
+            for (const record of existing)
+                await params.service.update(record.id, { value, metadata }, context);
+        }
+        else {
+            await params.service.create({ ...query, value, metadata }, context);
+        }
+    };
+    for (const token of tokens)
+        await write(token.name, token.value, token.expiresIn);
+    if (refresh !== undefined)
+        await write('refreshToken', refresh, input.refreshExpiresIn);
+}
+//# sourceMappingURL=oauth.js.map

package/dist/server/oauth.js.map

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

package/dist/sharepoint/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * SharePoint Storage Adapter
+ *
+ * Exports descriptor, implementation, and types for the
+ * SharePoint document storage adapter backed by Graph API.
+ */
+export { SharePointStorageAdapter } from './sharepoint.adapter.impl.ts';
+export { default as sharepointAdapterDescriptor } from './sharepoint.adapter.descriptor.ts';
+export { default as sharepointAdapterImpl, createSharePointAdapterImplementation } from './sharepoint.adapter.impl.ts';
+export { SharePointDocumentRecordSchema, SharePointUploadMetadataSchema, SharePointListOptionsSchema, SharePointAdapterConfigSchema, type SharePointDocumentRecord, type SharePointUploadMetadata, type SharePointListOptions, type SharePointAdapterConfig } from './sharepoint.schemas.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/sharepoint/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sharepoint/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EACN,OAAO,IAAI,qBAAqB,EAChC,qCAAqC,EACrC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACN,8BAA8B,EAC9B,8BAA8B,EAC9B,2BAA2B,EAC3B,6BAA6B,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,MAAM,yBAAyB,CAAC"}

package/dist/sharepoint/index.js

@@ -0,0 +1,11 @@
+/**
+ * SharePoint Storage Adapter
+ *
+ * Exports descriptor, implementation, and types for the
+ * SharePoint document storage adapter backed by Graph API.
+ */
+export { SharePointStorageAdapter } from "./sharepoint.adapter.impl.js";
+export { default as sharepointAdapterDescriptor } from "./sharepoint.adapter.descriptor.js";
+export { default as sharepointAdapterImpl, createSharePointAdapterImplementation } from "./sharepoint.adapter.impl.js";
+export { SharePointDocumentRecordSchema, SharePointUploadMetadataSchema, SharePointListOptionsSchema, SharePointAdapterConfigSchema } from "./sharepoint.schemas.js";
+//# sourceMappingURL=index.js.map

package/dist/sharepoint/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sharepoint/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EAAE,OAAO,IAAI,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAC5F,OAAO,EACN,OAAO,IAAI,qBAAqB,EAChC,qCAAqC,EACrC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACN,8BAA8B,EAC9B,8BAA8B,EAC9B,2BAA2B,EAC3B,6BAA6B,EAK7B,MAAM,yBAAyB,CAAC"}

package/dist/sharepoint/sharepoint.adapter.descriptor.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SharePoint Storage Adapter Descriptor
+ *
+ * Runtime descriptor for the SharePoint document storage adapter.
+ * Implements the storage/adapter kind with document protocol support.
+ */
+import type { StorageAdapterDescriptor } from '@vibesdotdev/storage/schemas/adapter-descriptor';
+declare const descriptor: StorageAdapterDescriptor;
+export default descriptor;
+//# sourceMappingURL=sharepoint.adapter.descriptor.d.ts.map

package/dist/sharepoint/sharepoint.adapter.descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharepoint.adapter.descriptor.d.ts","sourceRoot":"","sources":["../../src/sharepoint/sharepoint.adapter.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAEhG,QAAA,MAAM,UAAU,EAAE,wBAyBjB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/sharepoint/sharepoint.adapter.descriptor.js

@@ -0,0 +1,32 @@
+/**
+ * SharePoint Storage Adapter Descriptor
+ *
+ * Runtime descriptor for the SharePoint document storage adapter.
+ * Implements the storage/adapter kind with document protocol support.
+ */
+const descriptor = {
+    id: 'sharepoint',
+    kind: 'storage/adapter',
+    name: 'SharePoint Storage',
+    description: 'Document + object storage backed by Microsoft SharePoint via Graph API. Supports browsing, uploading, downloading, and deleting documents and blobs.',
+    tags: ['storage', 'sharepoint', 'microsoft', 'graph', 'documents', 'cloud'],
+    hardware: ['consumer'],
+    enabled: true,
+    // Storage-specific fields
+    protocols: ['document', 'object'],
+    basePathSemantics: 'unused',
+    capabilities: ['list', 'read', 'write', 'browse', 'search'],
+    requiresPairSchema: false,
+    supportsTransactions: false,
+    supportsTTL: false,
+    supportsSearch: true,
+    supportsFTS: false,
+    persistent: true,
+    supportsSubscription: false,
+    supportsHierarchy: true,
+    supportsComputedFields: false,
+    supportsSideEffects: false,
+    supportsRawQueries: false
+};
+export default descriptor;
+//# sourceMappingURL=sharepoint.adapter.descriptor.js.map

package/dist/sharepoint/sharepoint.adapter.descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sharepoint.adapter.descriptor.js","sourceRoot":"","sources":["../../src/sharepoint/sharepoint.adapter.descriptor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,UAAU,GAA6B;IAC5C,EAAE,EAAE,YAAY;IAChB,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACV,sJAAsJ;IACvJ,IAAI,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC;IAC3E,QAAQ,EAAE,CAAC,UAAU,CAAC;IACtB,OAAO,EAAE,IAAI;IAEb,0BAA0B;IAC1B,SAAS,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IACjC,iBAAiB,EAAE,QAAQ;IAC3B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAC3D,kBAAkB,EAAE,KAAK;IACzB,oBAAoB,EAAE,KAAK;IAC3B,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,KAAK;IAClB,UAAU,EAAE,IAAI;IAChB,oBAAoB,EAAE,KAAK;IAC3B,iBAAiB,EAAE,IAAI;IACvB,sBAAsB,EAAE,KAAK;IAC7B,mBAAmB,EAAE,KAAK;IAC1B,kBAAkB,EAAE,KAAK;CACzB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/sharepoint/sharepoint.adapter.impl.d.ts

@@ -0,0 +1,195 @@
+/**
+ * SharePoint Storage Adapter Implementation
+ *
+ * Wraps the GraphSharePointClient in the StorageAdapterInterface.
+ * Provides document protocol operations: list, get, put, delete
+ * against SharePoint drives via Microsoft Graph API.
+ *
+ * Usage:
+ * ```ts
+ * const adapter = await runtime.query('storage/adapter')
+ *   .withId('sharepoint').resolve();
+ * const store = adapter.documentStore(containerId, schema);
+ * ```
+ */
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import { SharePointFolderManifestSchema } from '../schemas/sharepoint.ts';
+import { SharePointAdapterConfigSchema } from './sharepoint.schemas.ts';
+import { z } from 'zod/v4';
+import type { StorageAdapterCapabilities, StorageHealthStatus } from '@vibesdotdev/storage/interfaces/adapter';
+import type { StorageDocumentStoreInterface } from '@vibesdotdev/storage/interfaces/document-store';
+import type { StorageObjectStoreInterface } from '@vibesdotdev/storage/interfaces/object-store';
+import type { StorageKeyValueInterface } from '@vibesdotdev/storage/interfaces/key-value';
+import type { RepositoryOptions, StorageRepositoryInterface } from '@vibesdotdev/storage/interfaces/repository';
+import type { StorageRecordInterface } from '@vibesdotdev/storage/interfaces/record';
+import type { StorageRecordDescriptor } from '@vibesdotdev/storage/schemas/record';
+import type { StorageAdapterDescriptor, StorageDrive, StorageEntry } from '@vibesdotdev/storage/schemas/adapter-descriptor';
+import { GraphSharePointClient } from '../microsoft/graph-sharepoint-client.ts';
+import type { SharePointDocumentRecord } from './sharepoint.schemas.ts';
+type SharePointRuntimeConfig = z.input<typeof SharePointAdapterConfigSchema> & {
+    runtime?: RuntimeRef;
+};
+/**
+ * Storage adapter wrapping Microsoft Graph SharePoint client.
+ *
+ * Supports the document protocol for browsing, uploading,
+ * downloading, and deleting documents in SharePoint drives.
+ *
+ * The adapter requires a GraphSharePointClient instance
+ * which supplies its runtime-owned authenticated transport.
+ */
+export declare class SharePointStorageAdapter {
+    readonly id: string;
+    readonly capabilities: StorageAdapterCapabilities;
+    private config;
+    private client;
+    constructor(descriptor: StorageAdapterDescriptor);
+    configure(config: SharePointRuntimeConfig): void;
+    /**
+     * Set the GraphSharePointClient instance.
+     * Must be called before using the adapter.
+     */
+    setClient(client: GraphSharePointClient): void;
+    isConfigured(): boolean;
+    /**
+     * Ensure the GraphSharePointClient is available.
+     */
+    private ensureClient;
+    /**
+     * Resolve the GraphSharePointClient for a browse call.
+     *
+     * Prefers an explicitly-injected client (`setClient()`). Otherwise lazily
+     * resolves the delegated Microsoft integration provider from the runtime and
+     * builds a request-scoped reference-only client from it. Inside a request context
+     * (e.g. the platform-web `/api/storage/adapters/sharepoint/*` route wraps the
+     * call in `runWithRequestContext`) it binds to the calling user's delegated
+     * Graph token. This mirrors the integration-ops dispatch path so browse works
+     * without the singleton needing a pre-set client.
+     */
+    private resolveBrowseClient;
+    /**
+     * Get a document store for a SharePoint container.
+     *
+     * @param namespace - The SharePoint site ID (container ID)
+     * @param schema - Zod schema (validated on load)
+     * @param manifest - Optional folder path string for subfolder browsing
+     */
+    documentStore<T>(namespace: string, schema: z.ZodType<T>, manifest?: z.input<typeof SharePointFolderManifestSchema>): StorageDocumentStoreInterface<T>;
+    /**
+     * Get a key-addressed object store scoped to a SharePoint site + base folder.
+     * Keys are drive-relative paths under `basePath`. The Graph client is resolved
+     * lazily per call — the injected client (`setClient`) when present, else the
+     * configured Microsoft integration in the current request context (app-only
+     * or delegated, per `config.integrationId`).
+     *
+     * @param namespace Optional site id (falls back to `config.siteId`).
+     * @param config Optional `{ siteId?, basePath? }` overrides.
+     */
+    objectStore(namespace?: string, config?: SharePointRuntimeConfig): StorageObjectStoreInterface;
+    /**
+     * Enumerate the SharePoint sites this credential can reach.
+     *
+     * Each site is surfaced as a {@link StorageDrive} with `kind: 'site'`.
+     * Consumers use the returned `id` as `driveId` for {@link list}.
+     */
+    listDrives(): Promise<StorageDrive[]>;
+    /**
+     * Enumerate files and folders inside a SharePoint site's default drive.
+     *
+     * @param driveId - SharePoint site id (from {@link listDrives}).
+     * @param path - Path relative to the drive root. Defaults to the root
+     *   when omitted or empty.
+     * @returns Mixed `file` and `directory` entries at that path.
+     */
+    list(driveId: string, path?: string): Promise<StorageEntry[]>;
+    /**
+     * Search for files matching a text query within a SharePoint drive.
+     *
+     * Delegates to Graph's server-side recursive drive search so results can
+     * be deeply nested (not limited to one folder level like {@link list}).
+     * Only files are returned — Graph search hits are always file-type items.
+     *
+     * @param driveId - SharePoint site id (from {@link listDrives}).
+     * @param query - Free-text search query (file name + content for indexed types).
+     * @param opts.path - Optional drive-root-relative subtree to scope the search.
+     * @param opts.limit - Maximum number of results (default 50, max 200).
+     * @returns Matching entries as {@link StorageEntry}s.
+     */
+    search(driveId: string, query: string, opts?: {
+        path?: string;
+        limit?: number;
+    }): Promise<StorageEntry[]>;
+    /**
+     * Mint a fresh pre-authenticated download URL for a file entry (canonical
+     * `storage/adapter` source-mint extension). By ITEM ID first — Graph search
+     * hits can carry partial parent paths (observed: bare filenames for nested
+     * files), and ids survive moves/renames — falling back to path addressing.
+     * Config is per-call for the same reason as {@link objectStore}: the
+     * resolved adapter is shared, so `configure()` would race across scopes.
+     */
+    sourceUrlForEntry(driveId: string, ref: {
+        itemId?: string;
+        path?: string;
+    }, config?: SharePointRuntimeConfig): Promise<string | null>;
+    listItem(driveId: string, itemId: string): Promise<StorageEntry[]>;
+    /**
+     * List documents (files only) in a SharePoint site, returning the
+     * SharePoint-typed record shape. Distinct from the canonical
+     * {@link list} browse method which returns {@link StorageEntry}s of
+     * both files and folders.
+     *
+     * @param containerId - SharePoint site ID
+     */
+    listDocuments(containerId: string): Promise<SharePointDocumentRecord[]>;
+    /**
+     * Get a document with its content stream.
+     *
+     * @param documentId - Drive item ID
+     * @param siteId - Optional site ID (falls back to configured siteId)
+     * @returns Object with metadata and content Blob
+     */
+    get(documentId: string, siteId?: string): Promise<{
+        metadata: SharePointDocumentRecord;
+        content: Blob;
+    }>;
+    /**
+     * Upload a document to SharePoint.
+     *
+     * Uses the Graph API upload endpoint:
+     * PUT /sites/{site-id}/drive/root:/{folderPath}/{filename}:/content
+     *
+     * @param containerId - SharePoint site ID
+     * @param metadata - Upload metadata (name, contentType, conflictBehavior)
+     * @param content - File content as ArrayBuffer or Blob
+     * @returns Created document record
+     */
+    put(containerId: string, metadata: {
+        name: string;
+        contentType?: string;
+    }, content: ArrayBuffer | Blob): Promise<SharePointDocumentRecord>;
+    /**
+     * Delete a document from SharePoint.
+     *
+     * DELETE /sites/{site-id}/drive/items/{item-id}
+     *
+     * @param documentId - Drive item ID to delete
+     * @param siteId - Optional site ID (falls back to configured siteId)
+     */
+    delete(documentId: string, siteId?: string): Promise<void>;
+    keyValueStore<TKey, TValue>(_namespace: string, _keySchema: z.ZodType<TKey>, _valueSchema: z.ZodType<TValue>): StorageKeyValueInterface<TKey, TValue>;
+    repository<T>(_tableName: string, _schema: z.ZodType<T>, _options?: RepositoryOptions): StorageRepositoryInterface<T>;
+    record<T = unknown>(_descriptor: StorageRecordDescriptor): StorageRecordInterface<T>;
+    ensureReady(): Promise<void>;
+    getDatabaseConnection(): never;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+    healthCheck(): Promise<StorageHealthStatus>;
+}
+/**
+ * Builds one adapter instance for one runtime. The adapter holds per-configure
+ * state (`config.runtime`, injected client), so the plugin's loader calls this
+ * once per runtime; a module-level instance would cross-talk between runtimes.
+ */
+export declare function createSharePointAdapterImplementation(): import("@vibesdotdev/kernel").RuntimeImplementationWrapper<SharePointStorageAdapter>;
+export default createSharePointAdapterImplementation;
+//# sourceMappingURL=sharepoint.adapter.impl.d.ts.map

package/dist/sharepoint/sharepoint.adapter.impl.d.ts.map

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