@decaf-ts/integrations 0.12.0 → 0.14.2

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"}

package/lib/esm/sftp/aws/index.js

@@ -0,0 +1,7 @@
+/**
+ * @module integrations/sftp/aws
+ * @summary AWS SFTP integration exports.
+ */
+export * from "./AwsSftpService.js";
+export * from "./AwsSftpEnvironment.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/sftp/aws/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/sftp/aws/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oCAAiC;AACjC,wCAAqC"}

package/lib/esm/sftp/ssh2/index.js

@@ -0,0 +1,7 @@
+/**
+ * @module integrations/sftp/ssh2
+ * @summary SSH2 SFTP integration exports.
+ */
+export * from "./Ssh2SftpService.js";
+export * from "./Ssh2SftpEnvironment.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/sftp/ssh2/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/sftp/ssh2/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qCAAkC;AAClC,yCAAsC"}

package/lib/types/calendar/environment.d.cts

@@ -0,0 +1,48 @@
+/**
+ * @description Environment shape for the calendar integration services
+ * @summary Defines the `calendar` root with the `googleCalendar` slice. The
+ * slice carries the OAuth `token` and/or `apiKey`, the default `calendarId`,
+ * and an optional `baseUrl` override and `timeout`. Fields are typed as
+ * required here so `LoggedEnvironment.accumulate` registers them; absent values
+ * resolve to proxy placeholders at runtime and must pass through
+ * `envString`/`envNumber`. Values are credential references supplied by the
+ * environment, never literals embedded in source.
+ * @memberOf module:integrations/calendar/environment
+ */
+export interface CalendarEnvironmentShape {
+    calendar: {
+        /** Google Calendar OAuth token/API key and default calendar (`calendar/google-calendar`). */
+        googleCalendar: {
+            token: string;
+            apiKey: string;
+            calendarId: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+    };
+}
+/**
+ * @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 declare const CalendarEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & CalendarEnvironmentShape>;

package/lib/types/calendar/environment.d.mts

@@ -0,0 +1,48 @@
+/**
+ * @description Environment shape for the calendar integration services
+ * @summary Defines the `calendar` root with the `googleCalendar` slice. The
+ * slice carries the OAuth `token` and/or `apiKey`, the default `calendarId`,
+ * and an optional `baseUrl` override and `timeout`. Fields are typed as
+ * required here so `LoggedEnvironment.accumulate` registers them; absent values
+ * resolve to proxy placeholders at runtime and must pass through
+ * `envString`/`envNumber`. Values are credential references supplied by the
+ * environment, never literals embedded in source.
+ * @memberOf module:integrations/calendar/environment
+ */
+export interface CalendarEnvironmentShape {
+    calendar: {
+        /** Google Calendar OAuth token/API key and default calendar (`calendar/google-calendar`). */
+        googleCalendar: {
+            token: string;
+            apiKey: string;
+            calendarId: string;
+            baseUrl: string;
+            timeout?: number;
+        };
+    };
+}
+/**
+ * @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 declare const CalendarEnvironment: import("@decaf-ts/logging").AccumulatedEnvironment<{
+    app: string | undefined;
+} & import("@decaf-ts/logging").LoggingConfig<object> & {
+    env: any;
+} & CalendarEnvironmentShape>;