@zackbart/connecta 0.34.1 → 0.35.0

package/dist/providers/sheets/api.js

@@ -0,0 +1,133 @@
+// The complete reviewed 17-method Sheets inventory; hatches validate against the frozen index.
+import { Schema } from "effect";
+import { get, post, put, vendor } from "../../http/vendor.js";
+import { googleErrors } from "../_shared/google/kit.js";
+import { valueSafety } from "../_shared/rest/value-safety.js";
+import { sheetsIndex } from "./lib/hatch.js";
+import { SHEETS_VALUE_SAFETY } from "./safety.js";
+import { SHEETS_SCOPES } from "./lib/constants.js";
+export const SHEETS = {
+    provider: "Google Sheets",
+    api: "Google Sheets API",
+    scopes: SHEETS_SCOPES,
+    // A Drive file can be absent or simply not shared with this user.
+    notFound: "ambiguous",
+};
+const SpreadsheetId = { spreadsheetId: Schema.String };
+const optionalString = Schema.optionalKey(Schema.String);
+export const getSpreadsheet = get("getSpreadsheet", "/spreadsheets/:spreadsheetId", {
+    params: SpreadsheetId,
+    query: { includeGridData: optionalString, fields: optionalString },
+    success: Schema.Unknown,
+});
+const OPERATIONS = [
+    getSpreadsheet,
+    post("createSpreadsheet", "/spreadsheets", {
+        query: { fields: optionalString },
+        payload: Schema.Unknown,
+        success: Schema.Unknown,
+    }),
+    post("batchUpdate", "/spreadsheets/:spreadsheetId:batchUpdate", {
+        params: SpreadsheetId,
+        payload: Schema.Unknown,
+        success: Schema.Unknown,
+    }),
+    get("batchGetValues", "/spreadsheets/:spreadsheetId/values:batchGet", {
+        params: SpreadsheetId,
+        query: {
+            ranges: Schema.Array(Schema.String),
+            majorDimension: optionalString,
+            valueRenderOption: optionalString,
+            dateTimeRenderOption: optionalString,
+        },
+        success: Schema.Unknown,
+    }),
+    post("batchUpdateValues", "/spreadsheets/:spreadsheetId/values:batchUpdate", {
+        params: SpreadsheetId,
+        payload: Schema.Unknown,
+        success: Schema.Unknown,
+    }),
+    post("batchClearValues", "/spreadsheets/:spreadsheetId/values:batchClear", {
+        params: SpreadsheetId,
+        payload: Schema.Unknown,
+        success: Schema.Unknown,
+    }),
+    post("appendValues", "/spreadsheets/:spreadsheetId/values/:range:append", {
+        params: { ...SpreadsheetId, range: Schema.String },
+        query: {
+            valueInputOption: Schema.String,
+            insertDataOption: Schema.String,
+            includeValuesInResponse: optionalString,
+        },
+        payload: Schema.Unknown,
+        success: Schema.Unknown,
+    }),
+    get("getValues", "/spreadsheets/:spreadsheetId/values/:range", {
+        params: { ...SpreadsheetId, range: Schema.String },
+        success: Schema.Unknown,
+    }),
+    put("updateValues", "/spreadsheets/:spreadsheetId/values/:range", {
+        params: { ...SpreadsheetId, range: Schema.String },
+        payload: Schema.Unknown,
+        success: Schema.Unknown,
+    }),
+    post("clearValues", "/spreadsheets/:spreadsheetId/values/:range:clear", {
+        params: { ...SpreadsheetId, range: Schema.String },
+        payload: Schema.Unknown,
+        success: Schema.Unknown,
+    }),
+    get("getDeveloperMetadata", "/spreadsheets/:spreadsheetId/developerMetadata/:metadataId", {
+        params: { ...SpreadsheetId, metadataId: Schema.String },
+        success: Schema.Unknown,
+    }),
+    post("searchDeveloperMetadata", "/spreadsheets/:spreadsheetId/developerMetadata:search", {
+        params: SpreadsheetId,
+        payload: Schema.Unknown,
+        success: Schema.Unknown,
+    }),
+    post("getByDataFilter", "/spreadsheets/:spreadsheetId:getByDataFilter", {
+        params: SpreadsheetId,
+        payload: Schema.Unknown,
+        success: Schema.Unknown,
+    }),
+    post("batchGetByDataFilter", "/spreadsheets/:spreadsheetId/values:batchGetByDataFilter", {
+        params: SpreadsheetId,
+        payload: Schema.Unknown,
+        success: Schema.Unknown,
+    }),
+    post("batchClearByDataFilter", "/spreadsheets/:spreadsheetId/values:batchClearByDataFilter", {
+        params: SpreadsheetId,
+        payload: Schema.Unknown,
+        success: Schema.Unknown,
+    }),
+    post("batchUpdateByDataFilter", "/spreadsheets/:spreadsheetId/values:batchUpdateByDataFilter", {
+        params: SpreadsheetId,
+        payload: Schema.Unknown,
+        success: Schema.Unknown,
+    }),
+    post("copySheet", "/spreadsheets/:spreadsheetId/sheets/:sheetId:copyTo", {
+        params: { ...SpreadsheetId, sheetId: Schema.String },
+        payload: Schema.Unknown,
+        success: Schema.Unknown,
+    }),
+];
+export const SheetsApi = vendor({ name: "Google Sheets", manifestBase: "/v4" }, ...OPERATIONS);
+export const errors = googleErrors(SHEETS, { standard: true });
+const values = valueSafety(SHEETS_VALUE_SAFETY, () => sheetsIndex);
+export const safety = {
+    reviewed: {
+        resolve: (method, path) => {
+            const op = sheetsIndex.resolve(method, path).op;
+            return { method: op.method, template: op.path };
+        },
+        redact: (data, op) => values.redact(data, op.method, op.template),
+        withholdsErrors: (op) => values.withholdsErrors(sheetsIndex.ops.find((entry) => entry.method === op.method && entry.path === op.template)),
+    },
+    sensitiveFields: { names: [], choice: "drop" },
+};
+// Delegation has no operator credential slot to probe. Never run.
+export const probe = {
+    operation: getSpreadsheet,
+    request: { params: { spreadsheetId: "-" } },
+    describe: () => "Google Sheets delegation has no credential to test.",
+};

package/dist/providers/sheets/index.d.ts

@@ -1,17 +1,6 @@
 import { type GoogleWorkspaceOptions } from "../_shared/google/workspace.js";
+export { SHEETS_API_BASE_URL, SHEETS_SCOPES } from "./lib/constants.js";
 export type { GoogleServiceAccount, GoogleSubjectContext, GoogleWorkspaceOptions, GoogleWorkspaceSubject, } from "../_shared/google/workspace.js";
-/**
- * The Sheets API root. Every path the tools send is beneath
- * `/spreadsheets`; the delegated token decides which ones the user can open.
- */
-export declare const SHEETS_API_BASE_URL = "https://sheets.googleapis.com/v4";
-/**
- * Exactly the scope this connection requests, and what the Admin console's
- * domain-wide delegation entry must add for it. One scope reads and writes
- * every spreadsheet the user can open; Google offers no narrower one that
- * writes.
- */
-export declare const SHEETS_SCOPES: readonly ["https://www.googleapis.com/auth/spreadsheets"];
 /** Options for {@link sheets}: the shared Workspace delegation options. */
 export type SheetsOptions = GoogleWorkspaceOptions;
 /**
@@ -49,9 +38,8 @@ export type SheetsOptions = GoogleWorkspaceOptions;
  *    Agents never reach that function: give each pool they use an `owner`,
  *    the address they act as there (decisions/0006).
  *
- * Reads are read-only. `create_spreadsheet`, `add_sheet`, and `append_values`
- * are additive writes the host approves through call_destructive_tool or a
- * program on a writable endpoint; the value writes, `clear_values`, and the raw
- * `batch_update_spreadsheet` are destructive.
+ * Reads are read-only. Every write, including `create_spreadsheet`, `add_sheet`,
+ * `append_values` and `batch_update_spreadsheet`, uses call_destructive_tool or a
+ * program on a writable endpoint, with approval controlled by the host.
  */
 export declare const sheets: import("../../provider.js").ProviderFactory<GoogleWorkspaceOptions>;