@decaf-ts/integrations 0.12.0 → 0.14.0

package/lib/cjs/io/jira/JiraService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"io/jira/JiraService.cjs","sourceRoot":"","sources":["io/jira/JiraService.js"],"names":[],"mappings":"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"}

package/lib/cjs/io/jira/index.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./JiraService.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/lib/cjs/io/jira/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"io/jira/index.cjs","sourceRoot":"","sources":["io/jira/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAiC;AACjC,iCAAiC"}

package/lib/cjs/io/microsoft-excel/MicrosoftExcelService.cjs

@@ -0,0 +1,253 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MicrosoftExcelService = void 0;
+/**
+ * @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}.
+ */
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const environment_js_1 = require("./../environment.cjs");
+const environmentValue_js_1 = require("./../../shared/environmentValue.cjs");
+const index_js_1 = require("./../../shared/http/index.cjs");
+/**
+ * @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
+ */
+class MicrosoftExcelService extends index_js_1.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 = environment_js_1.IoEnvironment.io.microsoftExcel;
+        const token = (0, environmentValue_js_1.envString)(env?.token);
+        if (!token)
+            return undefined;
+        return {
+            token,
+            baseUrl: (0, environmentValue_js_1.envString)(env.baseUrl),
+            timeout: (0, environmentValue_js_1.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 db_decorators_1.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 db_decorators_1.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 (0, index_js_1.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 (0, index_js_1.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 (0, index_js_1.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 (0, index_js_1.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 db_decorators_1.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 (0, index_js_1.httpError)("Microsoft Excel", "add table row", error);
+        }
+    }
+}
+exports.MicrosoftExcelService = MicrosoftExcelService;
+//# sourceMappingURL=MicrosoftExcelService.js.map
+//# sourceMappingURL=MicrosoftExcelService.cjs.map

package/lib/cjs/io/microsoft-excel/MicrosoftExcelService.cjs.map

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

package/lib/cjs/io/microsoft-excel/index.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./MicrosoftExcelService.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/lib/cjs/io/microsoft-excel/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"io/microsoft-excel/index.cjs","sourceRoot":"","sources":["io/microsoft-excel/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,iCAAiC"}

package/lib/cjs/io/microsoft-sharepoint/MicrosoftSharePointService.cjs

@@ -0,0 +1,261 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MicrosoftSharePointService = void 0;
+/**
+ * @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}.
+ */
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const environment_js_1 = require("./../environment.cjs");
+const environmentValue_js_1 = require("./../../shared/environmentValue.cjs");
+const index_js_1 = require("./../../shared/http/index.cjs");
+/**
+ * @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
+ */
+class MicrosoftSharePointService extends index_js_1.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 = environment_js_1.IoEnvironment.io.microsoftSharePoint;
+        const token = (0, environmentValue_js_1.envString)(env?.token);
+        if (!token)
+            return undefined;
+        return {
+            token,
+            baseUrl: (0, environmentValue_js_1.envString)(env.baseUrl),
+            timeout: (0, environmentValue_js_1.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 db_decorators_1.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 (0, index_js_1.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 (0, index_js_1.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 (0, index_js_1.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 db_decorators_1.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 (0, index_js_1.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 db_decorators_1.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 (0, index_js_1.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 (0, index_js_1.httpError)("Microsoft SharePoint", "list drive items", error);
+        }
+    }
+}
+exports.MicrosoftSharePointService = MicrosoftSharePointService;
+//# sourceMappingURL=MicrosoftSharePointService.js.map
+//# sourceMappingURL=MicrosoftSharePointService.cjs.map

package/lib/cjs/io/microsoft-sharepoint/MicrosoftSharePointService.cjs.map

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

package/lib/cjs/io/microsoft-sharepoint/index.cjs

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./MicrosoftSharePointService.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

package/lib/cjs/io/microsoft-sharepoint/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"io/microsoft-sharepoint/index.cjs","sourceRoot":"","sources":["io/microsoft-sharepoint/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kEAAgD;AAChD,iCAAiC"}

package/lib/esm/calendar/environment.js

@@ -0,0 +1,44 @@
+/**
+ * @module integrations/calendar/environment
+ * @summary Environment contract and accumulated environment for the calendar integration services.
+ * @description Declares the `CalendarEnvironmentShape` consumed by the Google
+ * Calendar service's `configFromEnvironment()` implementation and the
+ * `CalendarEnvironment` singleton created via `LoggedEnvironment.accumulate`.
+ * Services read their credentials and defaults from the matching
+ * `calendar.<provider>` slice, using the `envString`/`envNumber` helpers from
+ * `shared/environmentValue` to reject unset-leaf proxies. The matching public
+ * subpath export is `@decaf-ts/integrations/calendar/google-calendar`.
+ */
+import { LoggedEnvironment } from "@decaf-ts/logging";
+/**
+ * @description Accumulated calendar environment singleton
+ * @summary The `LoggedEnvironment.accumulate`-registered instance backing the
+ * `CalendarEnvironmentShape` contract. The Google Calendar service reads
+ * `CalendarEnvironment.calendar.googleCalendar` inside
+ * `configFromEnvironment()` and translates it into its
+ * `HttpApiServiceConfig`-derived config. Credentials come from environment
+ * variables; for as-graph node usage those are provided as
+ * `GRAPH_CREDENTIAL_*` values (placeholders in this example).
+ * @example
+ * ```ts
+ * import { GoogleCalendarService } from "@decaf-ts/integrations/calendar/google-calendar";
+ *
+ * // with calendar.googleCalendar.token / calendarId configured in the environment
+ * const calendar = new GoogleCalendarService();
+ * await calendar.initialize();
+ * ```
+ * @constant {LoggedEnvironment} CalendarEnvironment
+ * @memberOf module:integrations/calendar/environment
+ */
+export const CalendarEnvironment = LoggedEnvironment.accumulate({
+    calendar: {
+        googleCalendar: {
+            token: "",
+            apiKey: "",
+            calendarId: "",
+            baseUrl: "",
+            timeout: undefined,
+        },
+    },
+});
+//# sourceMappingURL=environment.js.map