@decaf-ts/integrations 0.11.0 → 0.14.0

package/lib/esm/io/microsoft-excel/MicrosoftExcelService.js

@@ -0,0 +1,248 @@
+/**
+ * @module integrations/io/microsoft-excel/service
+ * @summary Microsoft Excel workbook integration service (Microsoft Graph).
+ * @description Exposes Graph workbook operations (worksheets, ranges, tables,
+ * and table rows) as an undecorated client-based service built on
+ * {@link HttpApiService}. Configuration comes from an explicit
+ * `MicrosoftExcelServiceConfig` or the `io.microsoftExcel` environment slice;
+ * the access token is sent as `Authorization: Bearer <token>`. Workbooks are
+ * addressed by OneDrive/SharePoint `itemId`, optionally within a `driveId`.
+ * Credentials are referenced from configuration (and, from as-graph nodes, from
+ * the resolved `microsoft-excel` credential secret) and are never embedded in
+ * source. Failures are mapped to decaf errors via {@link httpError}.
+ */
+import { InternalError } from "@decaf-ts/db-decorators";
+import { IoEnvironment } from "./../environment.js";
+import { envNumber, envString } from "./../../shared/environmentValue.js";
+import { HttpApiService, httpError, } from "./../../shared/http/index.js";
+/**
+ * @description Microsoft Excel (Graph) workbook integration service
+ * @summary An undecorated HTTP service for listing worksheets and tables,
+ * reading and writing ranges, and appending table rows. Every operation
+ * requires a Graph access token and a workbook `itemId`; missing credentials or
+ * identifiers raise `InternalError`, and transport failures are mapped to decaf
+ * errors via {@link httpError}.
+ * @class MicrosoftExcelService
+ * @extends HttpApiService
+ * @category IO
+ * @example
+ * ```ts
+ * import { MicrosoftExcelService } from "@decaf-ts/integrations/io/microsoft-excel";
+ *
+ * const excel = new MicrosoftExcelService();
+ * await excel.initialize({
+ *   token: process.env.GRAPH_CREDENTIAL_MICROSOFT_EXCEL_TOKEN,
+ * });
+ * const range = await excel.getRange({
+ *   itemId: process.env.EXCEL_ITEM_ID ?? "",
+ *   worksheet: "Sheet1",
+ *   range: "A1:C10",
+ * });
+ * ```
+ * @mermaid
+ * sequenceDiagram
+ *   autonumber
+ *   participant Caller
+ *   participant Service as MicrosoftExcelService
+ *   participant Graph as Microsoft Graph
+ *   Caller->>Service: updateRange(input)
+ *   activate Service
+ *   Service->>Service: requireAccessToken()
+ *   Service->>Graph: PATCH /me/drive/items/{id}/workbook/worksheets/{name}/range(...)
+ *   activate Graph
+ *   Graph-->>Service: updated range payload
+ *   deactivate Graph
+ *   Service-->>Caller: updated range payload
+ *   deactivate Service
+ * @memberOf module:integrations/io/microsoft-excel/service
+ */
+export class MicrosoftExcelService extends HttpApiService {
+    constructor() {
+        super(...arguments);
+        /**
+         * @description The provider name used in error messages
+         */
+        this.serviceName = "Microsoft Excel";
+    }
+    /**
+     * @description The Microsoft Graph base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://graph.microsoft.com/v1.0"`.
+     */
+    defaultBaseUrl() {
+        return "https://graph.microsoft.com/v1.0";
+    }
+    /**
+     * @description Builds the Microsoft Graph bearer authorization headers
+     * @summary Returns `Authorization: Bearer <token>` when configured, and no
+     * headers otherwise.
+     * @param {MicrosoftExcelServiceConfig} config - The resolved service configuration.
+     * @returns {Record<string, string>} The authorization headers (empty without a token).
+     */
+    authHeaders(config) {
+        return config.token ? { Authorization: `Bearer ${config.token}` } : {};
+    }
+    /**
+     * @description Reads the Excel credentials and defaults from the environment
+     * @summary Reads the `io.microsoftExcel` slice and returns a partial config
+     * when an access token is configured, `undefined` otherwise. Values pass
+     * through `envString`/`envNumber` to reject unset-leaf proxies.
+     * @returns {Partial<MicrosoftExcelServiceConfig> | undefined} A partial config, or `undefined` when no Excel token is configured.
+     */
+    configFromEnvironment() {
+        const env = IoEnvironment.io.microsoftExcel;
+        const token = envString(env?.token);
+        if (!token)
+            return undefined;
+        return {
+            token,
+            baseUrl: envString(env.baseUrl),
+            timeout: envNumber(env.timeout),
+        };
+    }
+    /**
+     * @description Asserts that a Microsoft Graph access token is configured
+     * @summary Delegates to the shared `requireToken()` guard used by every
+     * operation.
+     * @returns {void}
+     * @throws {InternalError} When the resolved config has no `token`.
+     */
+    requireAccessToken() {
+        this.requireToken();
+    }
+    /**
+     * @description Builds the Graph workbook path for a drive item
+     * @summary Uses `/drives/<driveId>/items/<itemId>/workbook` when a `driveId`
+     * is set, otherwise the signed-in user's `/me/drive/...` path.
+     * @param {ExcelWorkbookRef} input - The workbook reference.
+     * @returns {string} The workbook API path.
+     * @throws {InternalError} When `itemId` is empty.
+     */
+    workbookPath(input) {
+        if (!input.itemId) {
+            throw new InternalError("Microsoft Excel requires a workbook item id");
+        }
+        const item = encodeURIComponent(input.itemId);
+        return input.driveId
+            ? `/drives/${encodeURIComponent(input.driveId)}/items/${item}/workbook`
+            : `/me/drive/items/${item}/workbook`;
+    }
+    /**
+     * @description Builds the Graph worksheet range path
+     * @summary Appends the encoded worksheet and A1 `range(address=...)`
+     * segments to the workbook path.
+     * @param {ExcelRangeInput} input - The workbook, worksheet, and range.
+     * @returns {string} The worksheet range API path.
+     * @throws {InternalError} When the worksheet or range is empty.
+     */
+    rangePath(input) {
+        if (!input.worksheet || !input.range) {
+            throw new InternalError("Microsoft Excel requires a worksheet and range");
+        }
+        return `${this.workbookPath(input)}/worksheets/${encodeURIComponent(input.worksheet)}/range(address='${encodeURIComponent(input.range)}')`;
+    }
+    /**
+     * @description Lists the worksheets in a workbook
+     * @summary `GET`s the workbook's `/worksheets` collection.
+     * @param {ExcelWorkbookRef} input - The workbook reference.
+     * @returns {Promise<unknown>} The Graph worksheet collection.
+     * @throws {InternalError} When no token is configured or `itemId` is empty.
+     * @throws {NotFoundError} When the workbook does not exist (HTTP 404).
+     * @throws {BadRequestError} When Graph rejects the request.
+     */
+    async listWorksheets(input) {
+        this.requireAccessToken();
+        try {
+            const response = await this.client.get(`${this.workbookPath(input)}/worksheets`);
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Microsoft Excel", "list worksheets", error);
+        }
+    }
+    /**
+     * @description Reads values from a worksheet range
+     * @summary `GET`s the addressed range and returns its values and formatting
+     * payload.
+     * @param {ExcelRangeInput} input - The workbook, worksheet, and range.
+     * @returns {Promise<unknown>} The range payload.
+     * @throws {InternalError} When no token is configured, or the workbook, worksheet, or range is empty.
+     * @throws {NotFoundError} When the workbook or range does not exist (HTTP 404).
+     * @throws {BadRequestError} When Graph rejects the request.
+     */
+    async getRange(input) {
+        this.requireAccessToken();
+        try {
+            const response = await this.client.get(this.rangePath(input));
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Microsoft Excel", "get range", error);
+        }
+    }
+    /**
+     * @description Writes values into a worksheet range
+     * @summary `PATCH`es the addressed range with the supplied `values` matrix
+     * and returns the updated range payload.
+     * @param {ExcelRangeWriteInput} input - The range reference and values to write.
+     * @returns {Promise<unknown>} The updated range payload.
+     * @throws {InternalError} When no token is configured, or the workbook, worksheet, or range is empty.
+     * @throws {NotFoundError} When the workbook or range does not exist (HTTP 404).
+     * @throws {BadRequestError} When Graph rejects the request.
+     */
+    async updateRange(input) {
+        this.requireAccessToken();
+        try {
+            const response = await this.client.patch(this.rangePath(input), {
+                values: input.values,
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Microsoft Excel", "update range", error);
+        }
+    }
+    /**
+     * @description Lists the tables in a workbook
+     * @summary `GET`s the workbook's `/tables` collection.
+     * @param {ExcelWorkbookRef} input - The workbook reference.
+     * @returns {Promise<unknown>} The Graph table collection.
+     * @throws {InternalError} When no token is configured or `itemId` is empty.
+     * @throws {NotFoundError} When the workbook does not exist (HTTP 404).
+     * @throws {BadRequestError} When Graph rejects the request.
+     */
+    async listTables(input) {
+        this.requireAccessToken();
+        try {
+            const response = await this.client.get(`${this.workbookPath(input)}/tables`);
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Microsoft Excel", "list tables", error);
+        }
+    }
+    /**
+     * @description Appends a row to an Excel table
+     * @summary `POST`s the single row to the table's `/rows/add` endpoint and
+     * returns the Graph row payload.
+     * @param {ExcelTableRowInput} input - The workbook, table, and row values.
+     * @returns {Promise<unknown>} The created table row payload.
+     * @throws {InternalError} When no token is configured, or the workbook, table, or values are missing.
+     * @throws {NotFoundError} When the workbook or table does not exist (HTTP 404).
+     * @throws {BadRequestError} When Graph rejects the request.
+     */
+    async addTableRow(input) {
+        this.requireAccessToken();
+        if (!input.tableId || !input.values?.length) {
+            throw new InternalError("Microsoft Excel addTableRow requires a table id and values");
+        }
+        try {
+            const response = await this.client.post(`${this.workbookPath(input)}/tables/${encodeURIComponent(input.tableId)}/rows/add`, { values: [input.values] });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Microsoft Excel", "add table row", error);
+        }
+    }
+}
+//# sourceMappingURL=MicrosoftExcelService.js.map

package/lib/esm/io/microsoft-excel/MicrosoftExcelService.js.map

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

package/lib/esm/io/microsoft-excel/index.js

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

package/lib/esm/io/microsoft-excel/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/io/microsoft-excel/index.ts"],"names":[],"mappings":"AAAA,2CAAwC"}

package/lib/esm/io/microsoft-sharepoint/MicrosoftSharePointService.js

@@ -0,0 +1,256 @@
+/**
+ * @module integrations/io/microsoft-sharepoint/service
+ * @summary Microsoft SharePoint integration service (Microsoft Graph).
+ * @description Exposes SharePoint site, list, list-item, and drive-item
+ * operations through Microsoft Graph `v1.0` as an undecorated client-based
+ * service built on {@link HttpApiService}. Configuration comes from an explicit
+ * `MicrosoftSharePointServiceConfig` or the `io.microsoftSharePoint` environment
+ * slice; the access token is sent as `Authorization: Bearer <token>`.
+ * Credentials are referenced from configuration (and, from as-graph nodes, from
+ * the resolved `microsoft-sharepoint` credential secret) and are never embedded
+ * in source. Failures are mapped to decaf errors via {@link httpError}.
+ */
+import { InternalError } from "@decaf-ts/db-decorators";
+import { IoEnvironment } from "./../environment.js";
+import { envNumber, envString } from "./../../shared/environmentValue.js";
+import { HttpApiService, httpError, } from "./../../shared/http/index.js";
+/**
+ * @description Microsoft SharePoint (Graph) integration service
+ * @summary An undecorated HTTP service for searching sites, reading a site's
+ * lists and list items, creating list items, and listing drive folder
+ * contents. Every operation requires a Graph access token; missing credentials
+ * or identifiers raise `InternalError`, and transport failures are mapped to
+ * decaf errors via {@link httpError}.
+ * @class MicrosoftSharePointService
+ * @extends HttpApiService
+ * @category IO
+ * @example
+ * ```ts
+ * import { MicrosoftSharePointService } from "@decaf-ts/integrations/io/microsoft-sharepoint";
+ *
+ * const sharepoint = new MicrosoftSharePointService();
+ * await sharepoint.initialize({
+ *   token: process.env.GRAPH_CREDENTIAL_MICROSOFT_SHAREPOINT_TOKEN,
+ * });
+ * const sites = await sharepoint.listSites("ops");
+ * ```
+ * @mermaid
+ * sequenceDiagram
+ *   autonumber
+ *   participant Caller
+ *   participant Service as MicrosoftSharePointService
+ *   participant Graph as Microsoft Graph
+ *   Caller->>Service: listItems(input)
+ *   activate Service
+ *   Service->>Service: requireAccessToken()
+ *   Service->>Graph: GET /sites/{siteId}/lists/{listId}/items
+ *   activate Graph
+ *   Graph-->>Service: list items payload
+ *   deactivate Graph
+ *   Service-->>Caller: list items payload
+ *   deactivate Service
+ * @memberOf module:integrations/io/microsoft-sharepoint/service
+ */
+export class MicrosoftSharePointService extends HttpApiService {
+    constructor() {
+        super(...arguments);
+        /**
+         * @description The provider name used in error messages
+         */
+        this.serviceName = "Microsoft SharePoint";
+    }
+    /**
+     * @description The Microsoft Graph base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://graph.microsoft.com/v1.0"`.
+     */
+    defaultBaseUrl() {
+        return "https://graph.microsoft.com/v1.0";
+    }
+    /**
+     * @description Builds the Microsoft Graph bearer authorization headers
+     * @summary Returns `Authorization: Bearer <token>` when configured, and no
+     * headers otherwise.
+     * @param {MicrosoftSharePointServiceConfig} config - The resolved service configuration.
+     * @returns {Record<string, string>} The authorization headers (empty without a token).
+     */
+    authHeaders(config) {
+        return config.token ? { Authorization: `Bearer ${config.token}` } : {};
+    }
+    /**
+     * @description Reads the SharePoint credentials and defaults from the environment
+     * @summary Reads the `io.microsoftSharePoint` slice and returns a partial
+     * config when an access token is configured, `undefined` otherwise. Values
+     * pass through `envString`/`envNumber` to reject unset-leaf proxies.
+     * @returns {Partial<MicrosoftSharePointServiceConfig> | undefined} A partial config, or `undefined` when no SharePoint token is configured.
+     */
+    configFromEnvironment() {
+        const env = IoEnvironment.io.microsoftSharePoint;
+        const token = envString(env?.token);
+        if (!token)
+            return undefined;
+        return {
+            token,
+            baseUrl: envString(env.baseUrl),
+            timeout: envNumber(env.timeout),
+        };
+    }
+    /**
+     * @description Asserts that a Microsoft Graph access token is configured
+     * @summary Delegates to the shared `requireToken()` guard used by every
+     * operation.
+     * @returns {void}
+     * @throws {InternalError} When the resolved config has no `token`.
+     */
+    requireAccessToken() {
+        this.requireToken();
+    }
+    /**
+     * @description Builds the encoded path for a SharePoint site
+     * @summary Validates the site ID and URL-encodes it into `/sites/<id>`.
+     * @param {string} siteId - The SharePoint site ID.
+     * @returns {string} The site API path.
+     * @throws {InternalError} When `siteId` is empty.
+     */
+    sitePath(siteId) {
+        if (!siteId) {
+            throw new InternalError("Microsoft SharePoint requires a site id");
+        }
+        return `/sites/${encodeURIComponent(siteId)}`;
+    }
+    /**
+     * @description Searches SharePoint sites
+     * @summary `GET`s `/sites` with a `search` term (default `"*"`).
+     * @param {string} [search] - Site search term; defaults to `"*"`.
+     * @returns {Promise<unknown>} The site collection payload.
+     * @throws {InternalError} When no token is configured.
+     * @throws {BadRequestError} When Graph rejects the request.
+     */
+    async listSites(search = "*") {
+        this.requireAccessToken();
+        try {
+            const response = await this.client.get("/sites", {
+                params: { search },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Microsoft SharePoint", "list sites", error);
+        }
+    }
+    /**
+     * @description Fetches a SharePoint site
+     * @summary `GET`s `/sites/<id>` and returns the site payload.
+     * @param {string} siteId - The site ID to fetch.
+     * @returns {Promise<unknown>} The site payload.
+     * @throws {InternalError} When no token is configured or the site ID is empty.
+     * @throws {NotFoundError} When the site does not exist (HTTP 404).
+     * @throws {BadRequestError} When Graph rejects the request.
+     */
+    async getSite(siteId) {
+        this.requireAccessToken();
+        try {
+            const response = await this.client.get(this.sitePath(siteId));
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Microsoft SharePoint", "get site", error);
+        }
+    }
+    /**
+     * @description Lists the lists in a SharePoint site
+     * @summary `GET`s `/sites/<id>/lists`.
+     * @param {string} siteId - The site whose lists are listed.
+     * @returns {Promise<unknown>} The list collection payload.
+     * @throws {InternalError} When no token is configured or the site ID is empty.
+     * @throws {NotFoundError} When the site does not exist (HTTP 404).
+     * @throws {BadRequestError} When Graph rejects the request.
+     */
+    async listLists(siteId) {
+        this.requireAccessToken();
+        try {
+            const response = await this.client.get(`${this.sitePath(siteId)}/lists`);
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Microsoft SharePoint", "list lists", error);
+        }
+    }
+    /**
+     * @description Lists items in a SharePoint list
+     * @summary `GET`s the list's `/items` endpoint expanding `fields` and
+     * applying the optional `$top` and `$filter` options.
+     * @param {SharePointItemsInput} input - The site, list, and query options.
+     * @returns {Promise<unknown>} The list item collection payload.
+     * @throws {InternalError} When no token is configured, or the site or list ID is empty.
+     * @throws {NotFoundError} When the site or list does not exist (HTTP 404).
+     * @throws {BadRequestError} When Graph rejects the query.
+     */
+    async listItems(input) {
+        this.requireAccessToken();
+        if (!input.listId) {
+            throw new InternalError("Microsoft SharePoint requires a list id");
+        }
+        try {
+            const response = await this.client.get(`${this.sitePath(input.siteId)}/lists/${encodeURIComponent(input.listId)}/items`, {
+                params: {
+                    $expand: "fields",
+                    ...(input.top !== undefined ? { $top: input.top } : {}),
+                    ...(input.filter ? { $filter: input.filter } : {}),
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Microsoft SharePoint", "list items", error);
+        }
+    }
+    /**
+     * @description Creates a SharePoint list item
+     * @summary `POST`s the `fields` map to the list's `/items` endpoint.
+     * @param {SharePointListItemInput} input - The site, list, and item fields.
+     * @returns {Promise<unknown>} The created item payload.
+     * @throws {InternalError} When no token is configured, or the site, list, or fields are missing.
+     * @throws {NotFoundError} When the site or list does not exist (HTTP 404).
+     * @throws {BadRequestError} When Graph rejects the item.
+     */
+    async createListItem(input) {
+        this.requireAccessToken();
+        if (!input.listId || !input.fields) {
+            throw new InternalError("Microsoft SharePoint createListItem requires a list id and fields");
+        }
+        try {
+            const response = await this.client.post(`${this.sitePath(input.siteId)}/lists/${encodeURIComponent(input.listId)}/items`, { fields: input.fields });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Microsoft SharePoint", "create list item", error);
+        }
+    }
+    /**
+     * @description Lists the children of a SharePoint drive folder
+     * @summary `GET`s `/sites/<id>/drive/items/<item or root>/children` with an
+     * optional `$top` cap.
+     * @param {SharePointDriveItemsInput} input - The site, folder, and result cap.
+     * @returns {Promise<unknown>} The drive item collection payload.
+     * @throws {InternalError} When no token is configured or the site ID is empty.
+     * @throws {NotFoundError} When the site or folder does not exist (HTTP 404).
+     * @throws {BadRequestError} When Graph rejects the request.
+     */
+    async listDriveItems(input) {
+        this.requireAccessToken();
+        const item = input.itemId ? encodeURIComponent(input.itemId) : "root";
+        try {
+            const response = await this.client.get(`${this.sitePath(input.siteId)}/drive/items/${item}/children`, {
+                params: {
+                    ...(input.top !== undefined ? { $top: input.top } : {}),
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Microsoft SharePoint", "list drive items", error);
+        }
+    }
+}
+//# sourceMappingURL=MicrosoftSharePointService.js.map

package/lib/esm/io/microsoft-sharepoint/MicrosoftSharePointService.js.map

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

package/lib/esm/io/microsoft-sharepoint/index.js

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

package/lib/esm/io/microsoft-sharepoint/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/io/microsoft-sharepoint/index.ts"],"names":[],"mappings":"AAAA,gDAA6C"}