@decaf-ts/integrations 0.11.0 → 0.12.0

package/lib/cjs/io/airtable/AirtableService.cjs

@@ -0,0 +1,266 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AirtableService = void 0;
+/**
+ * @module integrations/io/airtable/service
+ * @summary Airtable Web API integration service for CRUD operations on base records.
+ * @description Exposes the Airtable v0 records API (list, get, create, update,
+ * delete) as an undecorated client-based service built on
+ * {@link HttpApiService}. Configuration comes from an explicit
+ * `AirtableServiceConfig` or the `io.airtable` environment slice; base
+ * targets default to the configured `baseId` and can be overridden per call.
+ * 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 Airtable Web API integration service
+ * @summary An undecorated HTTP service for listing records
+ * with filtering, sorting, and cursor paging; fetching, creating, updating,
+ * and deleting individual records. Base targets resolve per call from the
+ * `baseId` argument, falling back to the configured value, and throw
+ * `InternalError` when unresolved. Every operation requires a token
+ * (`requireToken()`), and transport failures are mapped to decaf errors via
+ * {@link httpError}.
+ * @class AirtableService
+ * @category IO
+ * @example
+ * ```ts
+ * import { AirtableService } from "@decaf-ts/integrations/io/airtable";
+ *
+ * const airtable = new AirtableService();
+ * await airtable.initialize({
+ *   token: process.env.GRAPH_CREDENTIAL_AIRTABLE_TOKEN,
+ *   baseId: "appExampleBase",
+ * });
+ * const created = await airtable.createRecord({
+ *   table: "Tasks",
+ *   fields: { Name: "Ship release", Status: "Todo" },
+ * });
+ * ```
+ * @memberOf module:integrations/io/airtable/service
+ */
+class AirtableService extends index_js_1.HttpApiService {
+    constructor() {
+        super(...arguments);
+        /**
+         * @description The provider name used in error messages
+         */
+        this.serviceName = "Airtable";
+    }
+    /**
+     * @description The Airtable Web API v0 base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://api.airtable.com/v0"`.
+     */
+    defaultBaseUrl() {
+        return "https://api.airtable.com/v0";
+    }
+    /**
+     * @description Builds the Airtable bearer authorization headers
+     * @summary Returns the `Authorization: Bearer <token>` header when the
+     * config carries a token, and no headers otherwise.
+     * @param {AirtableServiceConfig} 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 Airtable credentials and defaults from the environment
+     * @summary Reads the `io.airtable` environment slice and returns a partial
+     * config when a token is configured, `undefined` otherwise. Values pass
+     * through `envString`/`envNumber` to reject unset-leaf proxies.
+     * @returns {Partial<AirtableServiceConfig> | undefined} A partial config, or `undefined` when no Airtable token is configured.
+     */
+    configFromEnvironment() {
+        const env = environment_js_1.IoEnvironment.io.airtable;
+        const token = (0, environmentValue_js_1.envString)(env?.token);
+        if (!token)
+            return undefined;
+        return {
+            token,
+            baseId: (0, environmentValue_js_1.envString)(env.baseId),
+            baseUrl: (0, environmentValue_js_1.envString)(env.baseUrl),
+            timeout: (0, environmentValue_js_1.envNumber)(env.timeout),
+        };
+    }
+    /**
+     * @description Resolves the URL-encoded base path for a call
+     * @summary Builds `/<baseId>` from the given base ID, falling back to the
+     * configured value, and throws when neither is available.
+     * @param {string} [baseId] - The per-call base override.
+     * @returns {string} The URL-encoded base API path.
+     * @throws {InternalError} When neither the input nor the config yields a base ID.
+     */
+    basePath(baseId) {
+        const resolved = baseId ?? this.config.baseId;
+        if (!resolved) {
+            throw new db_decorators_1.InternalError("Airtable requires a base ID");
+        }
+        return `/${encodeURIComponent(resolved)}`;
+    }
+    /**
+     * @description Resolves the URL-encoded table path for a call
+     * @summary Builds `<basePath>/<table>` with both segments URL-encoded, and
+     * throws when the table name is empty (or the base cannot be resolved).
+     * @param {string} table - The table name or ID.
+     * @param {string} [baseId] - The per-call base override.
+     * @returns {string} The URL-encoded table API path.
+     * @throws {InternalError} When the table name is empty or the base ID cannot be resolved.
+     */
+    tablePath(table, baseId) {
+        if (!table)
+            throw new db_decorators_1.InternalError("Airtable requires a table name");
+        return `${this.basePath(baseId)}/${encodeURIComponent(table)}`;
+    }
+    /**
+     * @description Lists records in an Airtable table with cursor paging
+     * @summary `GET`s the table endpoint with the configured view, formula
+     * filter, record caps, page size, page offset, field projection, and first
+     * sort entry. Return the `offset` cursor as the next call's
+     * `AirtableListOptions.offset` to fetch further pages.
+     * @param {AirtableListOptions} options - The table and filter/sort/paging options.
+     * @param {string} [baseId] - The base override; falls back to the configured `baseId`.
+     * @returns {Promise<AirtableListResult>} The page of records and the next offset cursor when more pages exist.
+     * @throws {InternalError} When no token is configured or the table/base cannot be resolved.
+     * @throws {NotFoundError} When the base or table does not exist (HTTP 404).
+     * @throws {ConflictError} When Airtable answers with HTTP 409.
+     * @throws {BadRequestError} When Airtable answers with any other HTTP error status (e.g. invalid formula).
+     * @example
+     * ```ts
+     * let offset: string | undefined;
+     * do {
+     *   const page = await airtable.listRecords({
+     *     table: "Tasks",
+     *     filterByFormula: "{Status} = 'Active'",
+     *     pageSize: 100,
+     *     offset,
+     *     sort: [{ field: "Name", direction: "asc" }],
+     *   });
+     *   console.log(page.records);
+     *   offset = page.offset;
+     * } while (offset);
+     * ```
+     */
+    async listRecords(options, baseId) {
+        this.requireToken();
+        try {
+            const response = await this.client.get(this.tablePath(options.table, baseId), {
+                params: {
+                    view: options.view,
+                    filterByFormula: options.filterByFormula,
+                    maxRecords: options.maxRecords,
+                    pageSize: options.pageSize,
+                    offset: options.offset,
+                    "fields[]": options.fields,
+                    "sort[0][field]": options.sort?.[0]?.field,
+                    "sort[0][direction]": options.sort?.[0]?.direction,
+                },
+            });
+            return {
+                records: response.data.records ?? [],
+                offset: response.data.offset,
+            };
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Airtable", "list records", error);
+        }
+    }
+    /**
+     * @description Fetches a single Airtable record
+     * @summary `GET`s the table endpoint with the record ID appended and
+     * returns the record envelope.
+     * @param {string} table - The table name or ID.
+     * @param {string} recordId - The record ID to fetch (e.g. `"rec1234567890"`).
+     * @param {string} [baseId] - The base override; falls back to the configured `baseId`.
+     * @returns {Promise<AirtableRecord>} The record envelope.
+     * @throws {InternalError} When no token is configured or the table/base cannot be resolved.
+     * @throws {NotFoundError} When the record does not exist (HTTP 404).
+     * @throws {ConflictError} When Airtable answers with HTTP 409.
+     * @throws {BadRequestError} When Airtable answers with any other HTTP error status.
+     */
+    async getRecord(table, recordId, baseId) {
+        this.requireToken();
+        try {
+            const response = await this.client.get(`${this.tablePath(table, baseId)}/${encodeURIComponent(recordId)}`);
+            return response.data;
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Airtable", "get record", error);
+        }
+    }
+    /**
+     * @description Creates an Airtable record
+     * @summary `POST`s the fields map to the table endpoint; `typecast` lets
+     * Airtable coerce values into the column types (disabled by default).
+     * @param {AirtableWriteInput} input - The table, fields, and typecast option.
+     * @param {string} [baseId] - The base override; falls back to the configured `baseId`.
+     * @returns {Promise<AirtableRecord>} The created record envelope.
+     * @throws {InternalError} When no token is configured or the table/base cannot be resolved.
+     * @throws {NotFoundError} When the base or table does not exist (HTTP 404).
+     * @throws {ConflictError} When Airtable answers with HTTP 409.
+     * @throws {BadRequestError} When Airtable answers with any other HTTP error status (e.g. invalid field values).
+     */
+    async createRecord(input, baseId) {
+        this.requireToken();
+        try {
+            const response = await this.client.post(this.tablePath(input.table, baseId), { fields: input.fields, typecast: input.typecast ?? false });
+            return response.data;
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Airtable", "create record", error);
+        }
+    }
+    /**
+     * @description Updates an Airtable record
+     * @summary `PATCH`es the fields map onto the record identified by
+     * `recordId`; only the provided fields change. `typecast` lets Airtable
+     * coerce values into the column types (disabled by default).
+     * @param {AirtableWriteInput & {recordId: string}} input - The table, fields, typecast option, and target record ID.
+     * @param {string} [baseId] - The base override; falls back to the configured `baseId`.
+     * @returns {Promise<AirtableRecord>} The updated record envelope.
+     * @throws {InternalError} When no token is configured or the table/base cannot be resolved.
+     * @throws {NotFoundError} When the record does not exist (HTTP 404).
+     * @throws {ConflictError} When Airtable answers with HTTP 409.
+     * @throws {BadRequestError} When Airtable answers with any other HTTP error status (e.g. invalid field values).
+     */
+    async updateRecord(input, baseId) {
+        this.requireToken();
+        try {
+            const response = await this.client.patch(`${this.tablePath(input.table, baseId)}/${encodeURIComponent(input.recordId)}`, { fields: input.fields, typecast: input.typecast ?? false });
+            return response.data;
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Airtable", "update record", error);
+        }
+    }
+    /**
+     * @description Deletes an Airtable record
+     * @summary `DELETE`s the record identified by `recordId` and returns the
+     * Airtable deletion confirmation.
+     * @param {string} table - The table name or ID.
+     * @param {string} recordId - The record ID to delete.
+     * @param {string} [baseId] - The base override; falls back to the configured `baseId`.
+     * @returns {Promise<{id: string, deleted: boolean}>} The deleted record's ID and Airtable's `deleted` confirmation.
+     * @throws {InternalError} When no token is configured or the table/base cannot be resolved.
+     * @throws {NotFoundError} When the record does not exist (HTTP 404).
+     * @throws {ConflictError} When Airtable answers with HTTP 409.
+     * @throws {BadRequestError} When Airtable answers with any other HTTP error status.
+     */
+    async deleteRecord(table, recordId, baseId) {
+        this.requireToken();
+        try {
+            const response = await this.client.delete(`${this.tablePath(table, baseId)}/${encodeURIComponent(recordId)}`);
+            return response.data;
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Airtable", "delete record", error);
+        }
+    }
+}
+exports.AirtableService = AirtableService;
+//# sourceMappingURL=AirtableService.js.map
+//# sourceMappingURL=AirtableService.cjs.map

package/lib/cjs/io/airtable/AirtableService.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"io/airtable/AirtableService.cjs","sourceRoot":"","sources":["io/airtable/AirtableService.js"],"names":[],"mappings":";;;AAAA;;;;;;;;;GASG;AACH,2DAAwD;AACxD,wDAAoD;AACpD,4EAA0E;AAC1E,2DAA0E;AAC1E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAa,eAAgB,SAAQ,yBAAc;IAC/C;QACI,KAAK,CAAC,GAAG,SAAS,CAAC,CAAC;QACpB;;WAEG;QACH,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;IAClC,CAAC;IACD;;;;OAIG;IACH,cAAc;QACV,OAAO,6BAA6B,CAAC;IACzC,CAAC;IACD;;;;;;OAMG;IACH,WAAW,CAAC,MAAM;QACd,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3E,CAAC;IACD;;;;;;OAMG;IACH,qBAAqB;QACjB,MAAM,GAAG,GAAG,8BAAa,CAAC,EAAE,CAAC,QAAQ,CAAC;QACtC,MAAM,KAAK,GAAG,IAAA,+BAAS,EAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK;YACN,OAAO,SAAS,CAAC;QACrB,OAAO;YACH,KAAK;YACL,MAAM,EAAE,IAAA,+BAAS,EAAC,GAAG,CAAC,MAAM,CAAC;YAC7B,OAAO,EAAE,IAAA,+BAAS,EAAC,GAAG,CAAC,OAAO,CAAC;YAC/B,OAAO,EAAE,IAAA,+BAAS,EAAC,GAAG,CAAC,OAAO,CAAC;SAClC,CAAC;IACN,CAAC;IACD;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM;QACX,MAAM,QAAQ,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,MAAM,IAAI,6BAAa,CAAC,6BAA6B,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,IAAI,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC9C,CAAC;IACD;;;;;;;;OAQG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM;QACnB,IAAI,CAAC,KAAK;YACN,MAAM,IAAI,6BAAa,CAAC,gCAAgC,CAAC,CAAC;QAC9D,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;IACnE,CAAC;IACD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM;QAC7B,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE;gBAC1E,MAAM,EAAE;oBACJ,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,eAAe,EAAE,OAAO,CAAC,eAAe;oBACxC,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,UAAU,EAAE,OAAO,CAAC,MAAM;oBAC1B,gBAAgB,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK;oBAC1C,oBAAoB,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS;iBACrD;aACJ,CAAC,CAAC;YACH,OAAO;gBACH,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE;gBACpC,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;aAC/B,CAAC;QACN,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACX,MAAM,IAAA,oBAAS,EAAC,UAAU,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;QACvD,CAAC;IACL,CAAC;IACD;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM;QACnC,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC3G,OAAO,QAAQ,CAAC,IAAI,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACX,MAAM,IAAA,oBAAS,EAAC,UAAU,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC;IACL,CAAC;IACD;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM;QAC5B,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC;YAC1I,OAAO,QAAQ,CAAC,IAAI,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACX,MAAM,IAAA,oBAAS,EAAC,UAAU,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;IACL,CAAC;IACD;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM;QAC5B,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC;YACtL,OAAO,QAAQ,CAAC,IAAI,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACX,MAAM,IAAA,oBAAS,EAAC,UAAU,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;IACL,CAAC;IACD;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM;QACtC,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC9G,OAAO,QAAQ,CAAC,IAAI,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,EAAE,CAAC;YACX,MAAM,IAAA,oBAAS,EAAC,UAAU,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;QACxD,CAAC;IACL,CAAC;CACJ;AA1ND,0CA0NC;AACD,2CAA2C"}

package/lib/cjs/io/airtable/index.cjs

@@ -0,0 +1,24 @@
+"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 });
+/**
+ * @module integrations/io/airtable
+ * @summary Airtable Web API service (record CRUD).
+ * @description Re-exports the Airtable client-based service and its types.
+ */
+__exportStar(require("./AirtableService.cjs"), exports);
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"io/airtable/index.cjs","sourceRoot":"","sources":["io/airtable/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;GAIG;AACH,uDAAqC;AACrC,iCAAiC"}

package/lib/cjs/io/environment.cjs

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IoEnvironment = void 0;
+const logging_1 = require("@decaf-ts/logging");
+/**
+ * @description Accumulated io environment singleton
+ * @summary The `LoggedEnvironment.accumulate`-registered instance backing the
+ * `IoEnvironmentShape` contract. IO services read their provider slice
+ * (e.g. `IoEnvironment.io.airtable`) inside `configFromEnvironment()` and
+ * translate it into an `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 { AirtableService } from "@decaf-ts/integrations/io/airtable";
+ *
+ * // with io.airtable.token / io.airtable.baseId configured in the environment
+ * const airtable = new AirtableService();
+ * await airtable.initialize();
+ * ```
+ * @constant {LoggedEnvironment} IoEnvironment
+ * @memberOf module:integrations/io/environment
+ */
+exports.IoEnvironment = logging_1.LoggedEnvironment.accumulate({
+    io: {
+        airtable: {
+            token: "",
+            baseUrl: "",
+            baseId: "",
+            timeout: undefined,
+        },
+        googleSheets: {
+            token: "",
+            apiKey: "",
+            baseUrl: "",
+            timeout: undefined,
+        },
+        graphql: {
+            endpoint: "",
+            token: "",
+            timeout: undefined,
+        },
+    },
+});
+//# sourceMappingURL=environment.js.map
+//# sourceMappingURL=environment.cjs.map

package/lib/cjs/io/environment.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"io/environment.cjs","sourceRoot":"","sources":["io/environment.js"],"names":[],"mappings":";;;AAAA,+CAAsD;AACtD;;;;;;;;;;;;;;;;;;GAkBG;AACU,QAAA,aAAa,GAAG,2BAAiB,CAAC,UAAU,CAAC;IACtD,EAAE,EAAE;QACA,QAAQ,EAAE;YACN,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,SAAS;SACrB;QACD,YAAY,EAAE;YACV,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAAS;SACrB;QACD,OAAO,EAAE;YACL,QAAQ,EAAE,EAAE;YACZ,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,SAAS;SACrB;KACJ;CACJ,CAAC,CAAC;AACH,uCAAuC"}

package/lib/cjs/io/google-sheets/GoogleSheetsService.cjs

@@ -0,0 +1,288 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GoogleSheetsService = void 0;
+/**
+ * @module integrations/io/google-sheets/service
+ * @summary Google Sheets API integration service for reading and writing spreadsheet values.
+ * @description Exposes the Google Sheets v4 values API (`get`, `update`,
+ * `append`, `clear`) and spreadsheet creation as an undecorated
+ * client-based service built on
+ * {@link HttpApiService}. Authentication accepts either an OAuth token
+ * (bearer) or a plain API key (`X-Goog-Api-Key`); configuration comes from an
+ * explicit `GoogleSheetsServiceConfig` or the `io.googleSheets` environment
+ * slice, and 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 Google Sheets API integration service
+ * @summary An undecorated HTTP service for reading,
+ * updating, appending, and clearing values in A1 ranges of a spreadsheet, and
+ * for creating new spreadsheets. Every operation requires either an OAuth
+ * token or an API key (`requireAuth()`); ranges and spreadsheet IDs are
+ * URL-encoded, and transport failures are mapped to decaf errors via
+ * {@link httpError}.
+ * @class GoogleSheetsService
+ * @category IO
+ * @example
+ * ```ts
+ * import { GoogleSheetsService } from "@decaf-ts/integrations/io/google-sheets";
+ *
+ * const sheets = new GoogleSheetsService();
+ * await sheets.initialize({
+ *   token: process.env.GRAPH_CREDENTIAL_GOOGLE_SHEETS_TOKEN,
+ * });
+ * const created = await sheets.createSpreadsheet("Metrics");
+ * await sheets.updateValues({
+ *   spreadsheetId: created.spreadsheetId,
+ *   range: "Sheet1!A1:B2",
+ *   values: [
+ *     ["date", "count"],
+ *     ["2026-01-01", "42"],
+ *   ],
+ * });
+ * ```
+ * @memberOf module:integrations/io/google-sheets/service
+ */
+class GoogleSheetsService extends index_js_1.HttpApiService {
+    constructor() {
+        super(...arguments);
+        /**
+         * @description The provider name used in error messages
+         */
+        this.serviceName = "Google Sheets";
+    }
+    /**
+     * @description The Google Sheets v4 values API base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://sheets.googleapis.com/v4/spreadsheets"`.
+     */
+    defaultBaseUrl() {
+        return "https://sheets.googleapis.com/v4/spreadsheets";
+    }
+    /**
+     * @description Builds the Google Sheets authorization headers
+     * @summary Returns the `Authorization: Bearer <token>` header when the
+     * config carries an OAuth token, otherwise the `X-Goog-Api-Key` header when
+     * an API key is configured, and no headers otherwise.
+     * @param {GoogleSheetsServiceConfig} config - The resolved service configuration.
+     * @returns {Record<string, string>} The authorization headers (empty without a token or API key).
+     */
+    authHeaders(config) {
+        if (config.token)
+            return { Authorization: `Bearer ${config.token}` };
+        if (config.apiKey)
+            return { "X-Goog-Api-Key": config.apiKey };
+        return {};
+    }
+    /**
+     * @description Reads the Google Sheets credentials and defaults from the environment
+     * @summary Reads the `io.googleSheets` environment slice and returns a
+     * partial config when a token or API key is configured, `undefined`
+     * otherwise. Values pass through `envString`/`envNumber` to reject
+     * unset-leaf proxies.
+     * @returns {Partial<GoogleSheetsServiceConfig> | undefined} A partial config, or `undefined` when neither token nor API key is configured.
+     */
+    configFromEnvironment() {
+        const env = environment_js_1.IoEnvironment.io.googleSheets;
+        const token = (0, environmentValue_js_1.envString)(env?.token);
+        const apiKey = (0, environmentValue_js_1.envString)(env?.apiKey);
+        if (!token && !apiKey)
+            return undefined;
+        return {
+            token,
+            apiKey,
+            baseUrl: (0, environmentValue_js_1.envString)(env.baseUrl),
+            timeout: (0, environmentValue_js_1.envNumber)(env.timeout),
+        };
+    }
+    /**
+     * @description Asserts that the service was configured with OAuth credentials
+     * @summary Throws when the resolved config carries neither a `token` nor an
+     * `apiKey`; every operation calls this before issuing requests.
+     * @returns {void}
+     * @throws {InternalError} When neither an OAuth token nor an API key is configured.
+     */
+    requireAuth() {
+        const config = this.config;
+        if (!config.token && !config.apiKey) {
+            throw new db_decorators_1.InternalError("Google Sheets requires an OAuth token or an API key");
+        }
+    }
+    /**
+     * @description URL-encodes an A1 range for the values API path
+     * @summary Ranges such as `Sheet1!A1:B2` contain characters that must be
+     * percent-encoded; all operations route the range through this helper.
+     * @param {string} range - The A1 notation range to encode.
+     * @returns {string} The URL-encoded range.
+     */
+    rangePath(range) {
+        return encodeURIComponent(range);
+    }
+    /**
+     * @description Reads values from an A1 range of a spreadsheet
+     * @summary `GET`s the values endpoint for the given `spreadsheetId` and
+     * `range` and returns the served range, major dimension, and the grid
+     * values (rows of cell strings). Requires credentials and both arguments.
+     * @param {string} spreadsheetId - The spreadsheet to read from.
+     * @param {string} range - The A1 notation range to read (e.g. `"Sheet1!A1:C10"`).
+     * @returns {Promise<GoogleSheetsValuesResult>} The served range and grid values.
+     * @throws {InternalError} When credentials are missing or the spreadsheet ID/range is empty.
+     * @throws {NotFoundError} When the spreadsheet does not exist (HTTP 404).
+     * @throws {ConflictError} When Google answers with HTTP 409.
+     * @throws {BadRequestError} When Google answers with any other HTTP error status (e.g. invalid range).
+     */
+    async getValues(spreadsheetId, range) {
+        this.requireAuth();
+        if (!spreadsheetId || !range) {
+            throw new db_decorators_1.InternalError("Google Sheets getValues requires a spreadsheet ID and range");
+        }
+        try {
+            const response = await this.client.get(`/${encodeURIComponent(spreadsheetId)}/values/${this.rangePath(range)}`);
+            return {
+                spreadsheetId,
+                range: response.data.range ?? range,
+                majorDimension: response.data.majorDimension,
+                values: response.data.values ?? [],
+            };
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Google Sheets", "get values", error);
+        }
+    }
+    /**
+     * @description Overwrites values in an A1 range of a spreadsheet
+     * @summary `PUT`s the row values to the values endpoint for the given
+     * `spreadsheetId` and `range`. Cells are interpreted according to
+     * `valueInputOption` (`"USER_ENTERED"` by default, `"RAW"` to store text
+     * verbatim), and the existing range content is replaced.
+     * @param {GoogleSheetsWriteInput} input - The target spreadsheet, range, values, and input interpretation.
+     * @returns {Promise<GoogleSheetsValuesResult>} The served range and the written values.
+     * @throws {InternalError} When credentials are missing.
+     * @throws {NotFoundError} When the spreadsheet does not exist (HTTP 404).
+     * @throws {ConflictError} When Google answers with HTTP 409.
+     * @throws {BadRequestError} When Google answers with any other HTTP error status (e.g. invalid range).
+     */
+    async updateValues(input) {
+        this.requireAuth();
+        try {
+            const response = await this.client.put(`/${encodeURIComponent(input.spreadsheetId)}/values/${this.rangePath(input.range)}`, {
+                range: input.range,
+                majorDimension: "ROWS",
+                values: input.values,
+            }, {
+                params: {
+                    valueInputOption: input.valueInputOption ?? "USER_ENTERED",
+                },
+            });
+            return {
+                spreadsheetId: input.spreadsheetId,
+                range: response.data.range ?? input.range,
+                majorDimension: response.data.majorDimension ?? "ROWS",
+                values: response.data.values ?? input.values,
+            };
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Google Sheets", "update values", error);
+        }
+    }
+    /**
+     * @description Appends values after the last row of an A1 range's table
+     * @summary `POST`s the row values to the `:append` endpoint for the given
+     * `spreadsheetId` and `range`, inserting new rows after existing table data
+     * (`insertDataOption: "INSERT_ROWS"`). Cells are interpreted according to
+     * `valueInputOption` (`"USER_ENTERED"` by default). Use a single-row or
+     * single-column A1 range to anchor the table; Google reports the range the
+     * data actually landed in.
+     * @param {GoogleSheetsWriteInput} input - The target spreadsheet, anchor range, values, and input interpretation.
+     * @returns {Promise<GoogleSheetsValuesResult>} The range the appended rows landed in and the appended values.
+     * @throws {InternalError} When credentials are missing.
+     * @throws {NotFoundError} When the spreadsheet does not exist (HTTP 404).
+     * @throws {ConflictError} When Google answers with HTTP 409.
+     * @throws {BadRequestError} When Google answers with any other HTTP error status (e.g. invalid range).
+     */
+    async appendValues(input) {
+        this.requireAuth();
+        try {
+            const response = await this.client.post(`/${encodeURIComponent(input.spreadsheetId)}/values/${this.rangePath(input.range)}:append`, {
+                range: input.range,
+                majorDimension: "ROWS",
+                values: input.values,
+            }, {
+                params: {
+                    valueInputOption: input.valueInputOption ?? "USER_ENTERED",
+                    insertDataOption: "INSERT_ROWS",
+                },
+            });
+            return {
+                spreadsheetId: input.spreadsheetId,
+                range: response.data.range ?? input.range,
+                majorDimension: response.data.majorDimension ?? "ROWS",
+                values: response.data.values ?? [],
+            };
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Google Sheets", "append values", error);
+        }
+    }
+    /**
+     * @description Clears all values in an A1 range of a spreadsheet
+     * @summary `POST`s the `:clear` endpoint for the given `spreadsheetId` and
+     * `range`, emptying the cells while preserving formatting, and returns the
+     * range Google actually cleared.
+     * @param {string} spreadsheetId - The spreadsheet to clear values in.
+     * @param {string} range - The A1 notation range to clear.
+     * @returns {Promise<{spreadsheetId: string, clearedRange: string}>} The cleared range as reported by Google.
+     * @throws {InternalError} When credentials are missing.
+     * @throws {NotFoundError} When the spreadsheet does not exist (HTTP 404).
+     * @throws {ConflictError} When Google answers with HTTP 409.
+     * @throws {BadRequestError} When Google answers with any other HTTP error status (e.g. invalid range).
+     */
+    async clearValues(spreadsheetId, range) {
+        this.requireAuth();
+        try {
+            const response = await this.client.post(`/${encodeURIComponent(spreadsheetId)}/values/${this.rangePath(range)}:clear`, {});
+            return {
+                spreadsheetId,
+                clearedRange: response.data.clearedRange ?? range,
+            };
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Google Sheets", "clear values", error);
+        }
+    }
+    /**
+     * @description Creates a new spreadsheet with the given title
+     * @summary `POST`s a spreadsheet resource with `properties.title` to the
+     * spreadsheets endpoint and returns the new spreadsheet's ID and URL.
+     * @param {string} title - The title for the new spreadsheet.
+     * @returns {Promise<{spreadsheetId: string, spreadsheetUrl?: string}>} The created spreadsheet's ID and URL.
+     * @throws {InternalError} When credentials are missing or the title is empty.
+     * @throws {NotFoundError} When Google answers with HTTP 404.
+     * @throws {ConflictError} When Google answers with HTTP 409.
+     * @throws {BadRequestError} When Google answers with any other HTTP error status.
+     */
+    async createSpreadsheet(title) {
+        this.requireAuth();
+        if (!title) {
+            throw new db_decorators_1.InternalError("Google Sheets createSpreadsheet requires a title");
+        }
+        try {
+            const response = await this.client.post("/", {
+                properties: { title },
+            });
+            return {
+                spreadsheetId: response.data.spreadsheetId,
+                spreadsheetUrl: response.data.spreadsheetUrl,
+            };
+        }
+        catch (error) {
+            throw (0, index_js_1.httpError)("Google Sheets", "create spreadsheet", error);
+        }
+    }
+}
+exports.GoogleSheetsService = GoogleSheetsService;
+//# sourceMappingURL=GoogleSheetsService.js.map
+//# sourceMappingURL=GoogleSheetsService.cjs.map

package/lib/cjs/io/google-sheets/GoogleSheetsService.cjs.map

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