@zackbart/connecta 0.28.0 → 0.28.1

package/dist/providers/cloudflare.js

@@ -9,7 +9,7 @@
  * alone keep this provider Workers-clean. `test/package-surface.test.ts` pins
  * it: no `cloudflare` package in any dependency field, every import relative.
  */
-import { api, defined } from "../connectors/api.js";
+import { apiConnector as api, defined } from "../connectors/api-connector.js";
 import { remoteMcp, withCredentialDefaults, } from "../connectors/remote-mcp.js";
 import { vettedCatalog, withVettedCatalog } from "../catalog-drift.js";
 import { guardedFetch, retryAfterMs, } from "../connectors/guarded-fetch.js";

package/dist/providers/linear.js

@@ -1,6 +1,6 @@
 import { remoteMcp, withCredentialDefaults, } from "../connectors/remote-mcp.js";
 import { vettedCatalog, withVettedCatalog } from "../catalog-drift.js";
-import { defined } from "../connectors/api.js";
+import { defined } from "../connectors/api-connector.js";
 /**
  * Linear publishes two hosted endpoints. `read-only` is not a client-side
  * filter: it advertises the `read` scope alone, so the token minted for it

package/dist/providers/mixpanel.js

@@ -1,6 +1,6 @@
 import { remoteMcp, withCredentialDefaults, } from "../connectors/remote-mcp.js";
 import { vettedCatalog, withVettedCatalog } from "../catalog-drift.js";
-import { defined } from "../connectors/api.js";
+import { defined } from "../connectors/api-connector.js";
 export const MIXPANEL_MCP_ENDPOINTS = {
     us: "https://mcp.mixpanel.com/mcp",
     eu: "https://mcp-eu.mixpanel.com/mcp",

package/dist/providers/notion.js

@@ -1,4 +1,4 @@
-import { api, defined } from "../connectors/api.js";
+import { apiConnector as api, defined } from "../connectors/api-connector.js";
 import { remoteMcp } from "../connectors/remote-mcp.js";
 import { vettedCatalog, withVettedCatalog } from "../catalog-drift.js";
 import { guardedFetch, retryAfterMs, } from "../connectors/guarded-fetch.js";

package/dist/providers/overflow.d.ts

@@ -0,0 +1,60 @@
+import type { Connector, ConnectorCallAdmissionPolicy } from "../types.js";
+/**
+ * Overflow's two published environments. They are separate deployments with
+ * separate credentials: a staging key works only against staging and a
+ * production key only against production.
+ */
+export declare const OVERFLOW_API_BASE_URLS: {
+    readonly production: "https://server.overflow.co";
+    readonly staging: "https://server.stage.overflow.co";
+};
+/** Which Overflow environment a connection talks to. */
+export type OverflowEnvironment = keyof typeof OVERFLOW_API_BASE_URLS;
+/** Options for the maintained Overflow connection. */
+export interface OverflowOptions {
+    /**
+     * Required, with no default. Production is live donor data and real money;
+     * staging is a separate sandbox with its own credentials. Neither is a safe
+     * thing to land on by omission — see the constructor for the argument.
+     */
+    environment: OverflowEnvironment;
+    /** Which nonprofit this connection reaches, and for whom. */
+    purpose: string;
+    /** Human-readable display name; defaults name the environment. */
+    title?: string;
+    /** Nonprofit-specific conventions appended to the maintained guide. */
+    instructions?: string;
+    /** Downstream auth ownership. Defaults to one shared deployment grant. */
+    authScope?: "shared" | "personal";
+    /**
+     * Replaces the default per-runtime admission policy, which transcribes
+     * Overflow's documented 120 requests per minute per client.
+     */
+    callAdmission?: ConnectorCallAdmissionPolicy;
+    /** Connector-specific inline result limit; omit to inherit the deployment. */
+    maxResultBytes?: number;
+    /** Default page size for page-numbered list tools. Defaults to 25; Overflow caps it at 100. */
+    defaultPageSize?: number;
+    /**
+     * API origin override for a proxy or test double. Connecta appends
+     * `/api/v3`. The declared `environment` still names what the proxy reaches.
+     */
+    baseUrl?: string;
+}
+/**
+ * A maintained Overflow connection.
+ *
+ * `environment` is required with no default, and the argument runs the other
+ * way from a provider whose environment rides the credential. Overflow
+ * publishes two base URLs and issues separate credentials for each, so a
+ * mismatch fails loudly with a 403 rather than reaching the wrong data — but
+ * that is exactly why a default buys nothing. Defaulting to staging, the
+ * "safe" side, sends every real deployment to a sandbox where its production
+ * key is refused with a generic "Forbidden resource" and no hint that the base
+ * URL is the problem. Defaulting to production makes a test deployment that
+ * forgot the option one pasted key away from charging real donors through the
+ * mutate hatch. The environment is a fact the operator knows and connecta
+ * cannot infer — Overflow's keys carry no recognizable environment marker — so
+ * the operator states it, and the title and the guide's first line repeat it.
+ */
+export declare function overflow(id: string, options: OverflowOptions): Connector;