@superblocksteam/sdk-api 2.0.103 → 2.0.104-next.1

package/src/integrations/base/types.ts

@@ -6,6 +6,9 @@ import type { z } from "zod";
 
 import type { TraceMetadata } from "../registry.js";
 
+// Re-export for backwards compatibility
+export type { TraceMetadata };
+
 /**
  * Options for making a generic REST API request.
  */
@@ -101,77 +104,3 @@ export interface SupportsApiRequest {
     metadata?: TraceMetadata,
   ): Promise<TResponse>;
 }
-
-/**
- * Schema configuration for streaming API request validation.
- */
-export interface StreamApiRequestSchema<TBody = unknown, TChunk = unknown> {
-  /**
-   * Optional Zod schema for request body validation.
-   * Required if body is provided in options.
-   */
-  body?: z.ZodSchema<TBody>;
-
-  /**
-   * Zod schema for validating each streamed chunk.
-   *
-   * Every chunk received from the stream is validated against this schema.
-   * Validation errors will terminate the stream.
-   */
-  chunk: z.ZodSchema<TChunk>;
-}
-
-/**
- * Interface for integration clients that support streaming API requests.
- *
- * Streaming API requests return an AsyncIterable of validated chunks,
- * enabling real-time data streaming from LLMs and other sources.
- */
-export interface SupportsStreamingApiRequest {
-  /**
-   * Execute a streaming API request with type-safe chunk validation.
-   *
-   * Returns an AsyncIterable that yields validated chunks as they arrive.
-   * Each chunk is validated against the provided schema before being yielded.
-   *
-   * @param options - Request configuration including method, path, params, and body
-   * @param schema - Zod schemas for request body and chunk validation (chunk schema REQUIRED)
-   * @param metadata - Optional trace metadata for observability (label, description)
-   * @returns AsyncIterable yielding validated chunks
-   *
-   * @example
-   * ```typescript
-   * const ChunkSchema = z.object({
-   *   id: z.string(),
-   *   choices: z.array(z.object({
-   *     delta: z.object({
-   *       content: z.string().optional(),
-   *     }),
-   *   })),
-   * });
-   *
-   * const stream = client.streamApiRequest(
-   *   {
-   *     method: 'POST',
-   *     path: '/v1/chat/completions',
-   *     body: {
-   *       model: 'gpt-4',
-   *       stream: true,
-   *       messages: [{ role: 'user', content: 'Hello!' }],
-   *     },
-   *   },
-   *   { chunk: ChunkSchema },
-   *   { label: 'openai.chatCompletions', description: 'Stream chat completion' }
-   * );
-   *
-   * for await (const chunk of stream) {
-   *   console.log(chunk.choices[0]?.delta?.content);
-   * }
-   * ```
-   */
-  streamApiRequest<TBody, TChunk>(
-    options: ApiRequestOptions<TBody>,
-    schema: StreamApiRequestSchema<TBody, TChunk>,
-    metadata?: TraceMetadata,
-  ): AsyncIterable<TChunk>;
-}

package/src/integrations/bigquery/README.md

@@ -40,7 +40,7 @@ export default api({
     const events = await ctx.integrations.bigquery.query(
       `SELECT event_id, event_name, user_id, timestamp
        FROM \`project.dataset.events\`
-       WHERE event_name = $1
+       WHERE event_name = ?
        LIMIT 100`,
       EventSchema,
       [event_name],
@@ -51,12 +51,16 @@ export default api({
 });
 ```
 
+The SDK currently binds BigQuery parameters from the positional `params` array.
+Even though native BigQuery also supports named parameters like `@event_name`,
+use `?` placeholders in SDK queries and pass values in array order.
+
 ### Executing INSERT, UPDATE, DELETE Statements
 
 ```typescript
 // INSERT
 await ctx.integrations.bigquery.execute(
-  "INSERT INTO `project.dataset.metrics` (name, value, timestamp) VALUES ($1, $2, CURRENT_TIMESTAMP())",
+  "INSERT INTO `project.dataset.metrics` (name, value, timestamp) VALUES (?, ?, CURRENT_TIMESTAMP())",
   ["cpu_usage", "75.5"],
 );
 ```
@@ -116,6 +120,27 @@ All methods accept an optional `metadata` parameter as the last argument for dia
 
 ## Common Pitfalls
 
+### SDK Parameters Are Positional
+
+The SDK accepts an array of parameter values and binds them server-side in
+order. When you need parameters, use `?` placeholders in the SQL text:
+
+```typescript
+// WRONG - Native BigQuery named parameter syntax is not the SDK contract
+await ctx.integrations.bigquery.query(
+  "SELECT * FROM `project.dataset.events` WHERE event_name = @event_name",
+  EventSchema,
+  ["signup"],
+);
+
+// CORRECT - Use positional params with ? placeholders
+await ctx.integrations.bigquery.query(
+  "SELECT * FROM `project.dataset.events` WHERE event_name = ?",
+  EventSchema,
+  ["signup"],
+);
+```
+
 ### Backtick Table References
 
 BigQuery uses backticks for fully-qualified table names:
@@ -165,7 +190,7 @@ BigQuery charges by data scanned. Use partitions and column selection:
 const query = `
   SELECT event_id, event_name
   FROM \`project.dataset.events\`
-  WHERE _PARTITIONDATE = $1
+  WHERE _PARTITIONDATE = ?
 `;
 ```
 

package/src/integrations/bigquery/types.ts

@@ -25,7 +25,7 @@ import type { TraceMetadata } from "../registry.js";
  * });
  *
  * const events = await bigquery.query(
- *   'SELECT * FROM events WHERE date = $1',
+ *   'SELECT * FROM events WHERE date = ?',
  *   EventSchema,
  *   ['2024-01-01']
  * );
@@ -35,9 +35,9 @@ export interface BigQueryClient extends BaseIntegrationClient {
   /**
    * Execute a SQL query and validate results against a Zod schema.
    *
-   * @param sql - SQL query string (use $1, $2, etc. for parameters)
+   * @param sql - SQL query string (use ? placeholders for parameters)
    * @param schema - Zod schema to validate the query results
-   * @param params - Optional query parameters
+   * @param params - Optional query parameters, bound positionally from the provided array
    * @returns Promise resolving to validated query results
    *
    * @throws {QueryValidationError} If results don't match schema

package/src/integrations/cohere/README.md

@@ -52,7 +52,7 @@ export default api({
     const result = await ctx.integrations.cohere.apiRequest(
       {
         method: "POST",
-        path: "/v1/chat",
+        path: "/chat",
         body: {
           model: "command-r-plus",
           message: message,
@@ -81,7 +81,7 @@ const EmbedResponseSchema = z.object({
 const result = await ctx.integrations.cohere.apiRequest(
   {
     method: "POST",
-    path: "/v1/embed",
+    path: "/embed",
     body: {
       model: "embed-english-v3.0",
       texts: ["Hello world", "How are you?"],
@@ -115,7 +115,7 @@ const ClassifyResponseSchema = z.object({
 const result = await ctx.integrations.cohere.apiRequest(
   {
     method: "POST",
-    path: "/v1/classify",
+    path: "/classify",
     body: {
       model: "embed-english-v3.0",
       inputs: ["This product is amazing!", "Terrible experience, never again"],
@@ -159,7 +159,7 @@ const documents = [
 const result = await ctx.integrations.cohere.apiRequest(
   {
     method: "POST",
-    path: "/v1/rerank",
+    path: "/rerank",
     body: {
       model: "rerank-english-v3.0",
       query: "What is the capital of the United States?",
@@ -193,7 +193,7 @@ const GenerateResponseSchema = z.object({
 const result = await ctx.integrations.cohere.apiRequest(
   {
     method: "POST",
-    path: "/v1/generate",
+    path: "/generate",
     body: {
       model: "command",
       prompt: "Write a creative story about",
@@ -220,7 +220,7 @@ await cohere.embed({ ... });
 
 // CORRECT - Use apiRequest
 await ctx.integrations.cohere.apiRequest(
-  { method: "POST", path: "/v1/chat", body: { ... } },
+  { method: "POST", path: "/chat", body: { ... } },
   { response: ChatResponseSchema }
 );
 ```
@@ -234,7 +234,7 @@ When creating embeddings, specify the correct `input_type`:
 const docEmbeddings = await ctx.integrations.cohere.apiRequest(
   {
     method: "POST",
-    path: "/v1/embed",
+    path: "/embed",
     body: {
       texts: documents,
       input_type: "search_document", // For documents
@@ -247,7 +247,7 @@ const docEmbeddings = await ctx.integrations.cohere.apiRequest(
 const queryEmbedding = await ctx.integrations.cohere.apiRequest(
   {
     method: "POST",
-    path: "/v1/embed",
+    path: "/embed",
     body: {
       texts: [query],
       input_type: "search_query", // For queries
@@ -266,7 +266,7 @@ The classify endpoint requires labeled examples:
 const result = await ctx.integrations.cohere.apiRequest(
   {
     method: "POST",
-    path: "/v1/classify",
+    path: "/classify",
     body: {
       inputs: ["Great product!"],
       // Missing examples!
@@ -279,7 +279,7 @@ const result = await ctx.integrations.cohere.apiRequest(
 const result = await ctx.integrations.cohere.apiRequest(
   {
     method: "POST",
-    path: "/v1/classify",
+    path: "/classify",
     body: {
       inputs: ["Great product!"],
       examples: [
@@ -299,7 +299,7 @@ import { RestApiValidationError } from "@superblocksteam/sdk-api";
 
 try {
   const result = await ctx.integrations.cohere.apiRequest(
-    { method: "POST", path: "/v1/chat", body: { ... } },
+    { method: "POST", path: "/chat", body: { ... } },
     { response: ChatResponseSchema }
   );
 } catch (error) {

package/src/integrations/databricks/README.md

@@ -38,7 +38,7 @@ export default api({
   }),
   async run(ctx, { date }) {
     const data = await ctx.integrations.databricks.query(
-      "SELECT id, value, timestamp FROM data WHERE date = $1",
+      "SELECT id, value, timestamp FROM data WHERE date = :PARAM_1",
       DataSchema,
       [date],
     );
@@ -48,25 +48,29 @@ export default api({
 });
 ```
 
+The SDK accepts Databricks parameters as a positional `params` array, but the
+SQL text should use `:PARAM_1`, `:PARAM_2`, and so on. The first array value
+binds to `:PARAM_1`, the second binds to `:PARAM_2`, and so forth.
+
 ### Executing INSERT, UPDATE, DELETE Statements
 
 ```typescript
 // INSERT
 await ctx.integrations.databricks.execute(
-  "INSERT INTO metrics (name, value) VALUES ($1, $2)",
+  "INSERT INTO metrics (name, value) VALUES (:PARAM_1, :PARAM_2)",
   ["cpu_usage", "75.5"],
 );
 
 // UPDATE
 const updateResult = await ctx.integrations.databricks.execute(
-  "UPDATE metrics SET value = $1 WHERE name = $2",
+  "UPDATE metrics SET value = :PARAM_1 WHERE name = :PARAM_2",
   ["80.0", "cpu_usage"],
 );
 console.log(`Updated ${updateResult.rowCount} rows`);
 
 // DELETE
 const deleteResult = await ctx.integrations.databricks.execute(
-  "DELETE FROM metrics WHERE timestamp < $1",
+  "DELETE FROM metrics WHERE timestamp < :PARAM_1",
   ["2024-01-01"],
 );
 console.log(`Deleted ${deleteResult.rowCount} rows`);
@@ -100,6 +104,27 @@ All methods accept an optional `metadata` parameter as the last argument for dia
 
 ## Common Pitfalls
 
+### Parameter Placeholders Must Match the SDK Contract
+
+Pass parameter values as an array, but write the SQL with `:PARAM_n`
+placeholders:
+
+```typescript
+// WRONG - Positional question marks are not the placeholder syntax this SDK emits
+await ctx.integrations.databricks.query(
+  "SELECT * FROM data WHERE date = ?",
+  DataSchema,
+  ["2024-01-01"],
+);
+
+// CORRECT - Use Databricks placeholders with positional params
+await ctx.integrations.databricks.query(
+  "SELECT * FROM data WHERE date = :PARAM_1",
+  DataSchema,
+  ["2024-01-01"],
+);
+```
+
 ### BIGINT/LONG Values Returned as Strings
 
 ```typescript

package/src/integrations/databricks/types.ts

@@ -25,7 +25,7 @@ import type { TraceMetadata } from "../registry.js";
  * });
  *
  * const data = await databricks.query(
- *   'SELECT * FROM data WHERE date = $1',
+ *   'SELECT * FROM data WHERE date = :PARAM_1',
  *   DataSchema,
  *   ['2024-01-01']
  * );
@@ -35,9 +35,9 @@ export interface DatabricksClient extends BaseIntegrationClient {
   /**
    * Execute a SQL query and validate results against a Zod schema.
    *
-   * @param sql - SQL query string (use $1, $2, etc. for parameters)
+   * @param sql - SQL query string (use :PARAM_1, :PARAM_2, etc. for parameters)
    * @param schema - Zod schema to validate the query results
-   * @param params - Optional query parameters
+   * @param params - Optional query parameters, bound positionally so the first value maps to :PARAM_1
    * @returns Promise resolving to validated query results
    *
    * @throws {QueryValidationError} If results don't match schema

package/src/integrations/documentation.test.ts

@@ -0,0 +1,122 @@
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { describe, expect, it } from "vitest";
+
+import { SUPPORTED_PLUGINS } from "./registry.js";
+
+const TEST_DIR = dirname(fileURLToPath(import.meta.url));
+
+type PlaceholderDocsCase = {
+  integrationId: string;
+  expectedPlaceholder: string;
+  rejectsPostgresStyle?: boolean;
+};
+
+const DOC_DIRECTORY_ALIASES = {
+  confluent: "kafka",
+  graphqlintegration: "graphql",
+  redpanda: "kafka",
+} as const;
+
+const DOC_DIRECTORY_EXCLUSIONS = new Set(["base"]);
+
+function hasDocDirectoryAlias(
+  pluginId: string,
+): pluginId is keyof typeof DOC_DIRECTORY_ALIASES {
+  return pluginId in DOC_DIRECTORY_ALIASES;
+}
+
+const EXPECTED_DOC_DIRECTORIES = Array.from(
+  new Set(
+    Object.values(SUPPORTED_PLUGINS)
+      .map((pluginId) =>
+        hasDocDirectoryAlias(pluginId)
+          ? DOC_DIRECTORY_ALIASES[pluginId]
+          : pluginId,
+      )
+      .filter((directory) => !DOC_DIRECTORY_EXCLUSIONS.has(directory)),
+  ),
+).sort();
+
+const ACTUAL_DOC_DIRECTORIES = readdirSync(TEST_DIR, { withFileTypes: true })
+  .filter((entry) => entry.isDirectory())
+  .map((entry) => entry.name)
+  .filter((directory) => !DOC_DIRECTORY_EXCLUSIONS.has(directory))
+  .sort();
+
+const PLACEHOLDER_DOC_CASES: PlaceholderDocsCase[] = [
+  { integrationId: "athena", expectedPlaceholder: "?" },
+  { integrationId: "bigquery", expectedPlaceholder: "?" },
+  {
+    integrationId: "cockroachdb",
+    expectedPlaceholder: "$1",
+    rejectsPostgresStyle: false,
+  },
+  { integrationId: "databricks", expectedPlaceholder: ":PARAM_1" },
+  { integrationId: "dynamodb", expectedPlaceholder: "?" },
+  {
+    integrationId: "lakebase",
+    expectedPlaceholder: "$1",
+    rejectsPostgresStyle: false,
+  },
+  { integrationId: "mariadb", expectedPlaceholder: "?" },
+  { integrationId: "mssql", expectedPlaceholder: "@PARAM_1" },
+  { integrationId: "mysql", expectedPlaceholder: "?" },
+  { integrationId: "oracledb", expectedPlaceholder: ":1" },
+  {
+    integrationId: "redshift",
+    expectedPlaceholder: "$1",
+    rejectsPostgresStyle: false,
+  },
+  { integrationId: "snowflake", expectedPlaceholder: "?" },
+  {
+    integrationId: "snowflakepostgres",
+    expectedPlaceholder: "$1",
+    rejectsPostgresStyle: false,
+  },
+];
+
+function readIntegrationFile(integrationId: string, fileName: string): string {
+  return readFileSync(resolve(TEST_DIR, integrationId, fileName), "utf8");
+}
+
+describe("SQL integration documentation", () => {
+  it("documents every supported integration directory", () => {
+    expect(ACTUAL_DOC_DIRECTORIES).toEqual(EXPECTED_DOC_DIRECTORIES);
+
+    for (const integrationId of EXPECTED_DOC_DIRECTORIES) {
+      expect(existsSync(resolve(TEST_DIR, integrationId, "README.md"))).toBe(
+        true,
+      );
+      expect(existsSync(resolve(TEST_DIR, integrationId, "types.ts"))).toBe(
+        true,
+      );
+    }
+  });
+
+  it.each(PLACEHOLDER_DOC_CASES)(
+    "$integrationId README uses $expectedPlaceholder placeholders",
+    ({ integrationId, expectedPlaceholder, rejectsPostgresStyle = true }) => {
+      const readme = readIntegrationFile(integrationId, "README.md");
+
+      expect(readme).toContain(expectedPlaceholder);
+      if (rejectsPostgresStyle) {
+        expect(readme).not.toMatch(/\$\d+/);
+      }
+    },
+  );
+
+  it.each(PLACEHOLDER_DOC_CASES)(
+    "$integrationId JSDoc uses $expectedPlaceholder placeholders",
+    ({ integrationId, expectedPlaceholder, rejectsPostgresStyle = true }) => {
+      const typeDocs = readIntegrationFile(integrationId, "types.ts");
+
+      expect(typeDocs).toContain(expectedPlaceholder);
+      if (rejectsPostgresStyle) {
+        expect(typeDocs).not.toMatch(/\$\d+/);
+      }
+    },
+  );
+});

package/src/integrations/fireworks/README.md

@@ -10,7 +10,9 @@ Interact with Fireworks AI's fast inference platform for LLM chat completions an
 
 ## Usage
 
-### Chat Completion
+### Step 1: List Available Models
+
+Model availability varies by account. Before making requests, validate which models are deployed on your account:
 
 ```typescript
 import { api, z, fireworks } from "@superblocksteam/sdk-api";
@@ -18,6 +20,30 @@ import { api, z, fireworks } from "@superblocksteam/sdk-api";
 // Integration ID from the integrations panel
 const PROD_FIREWORKS = "a1b2c3d4-5678-90ab-cdef-fireworks001";
 
+const ModelsResponseSchema = z.object({
+  data: z.array(
+    z.object({
+      id: z.string(),
+      object: z.string(),
+    }),
+  ),
+});
+
+const models = await ctx.integrations.fireworks.apiRequest(
+  {
+    method: "GET",
+    path: "/v1/models",
+  },
+  { response: ModelsResponseSchema },
+);
+
+// Use a model ID from the response in subsequent requests
+const availableModelId = models.data[0]?.id;
+```
+
+### Chat Completion
+
+```typescript
 const ChatCompletionResponseSchema = z.object({
   id: z.string(),
   object: z.string(),
@@ -55,7 +81,7 @@ export default api({
     const result = await ctx.integrations.fireworks.apiRequest(
       {
         method: "POST",
-        path: "/inference/v1/chat/completions",
+        path: "/v1/chat/completions",
         body: {
           model: "accounts/fireworks/models/llama-v3p1-70b-instruct",
           messages: [{ role: "user", content: prompt }],
@@ -76,7 +102,7 @@ export default api({
 const llama70b = await ctx.integrations.fireworks.apiRequest(
   {
     method: "POST",
-    path: "/inference/v1/chat/completions",
+    path: "/v1/chat/completions",
     body: {
       model: "accounts/fireworks/models/llama-v3p1-70b-instruct",
       messages: [{ role: "user", content: "Complex task..." }],
@@ -89,7 +115,7 @@ const llama70b = await ctx.integrations.fireworks.apiRequest(
 const llama8b = await ctx.integrations.fireworks.apiRequest(
   {
     method: "POST",
-    path: "/inference/v1/chat/completions",
+    path: "/v1/chat/completions",
     body: {
       model: "accounts/fireworks/models/llama-v3p1-8b-instruct",
       messages: [{ role: "user", content: "Simple task..." }],
@@ -102,7 +128,7 @@ const llama8b = await ctx.integrations.fireworks.apiRequest(
 const mixtral = await ctx.integrations.fireworks.apiRequest(
   {
     method: "POST",
-    path: "/inference/v1/chat/completions",
+    path: "/v1/chat/completions",
     body: {
       model: "accounts/fireworks/models/mixtral-8x7b-instruct",
       messages: [{ role: "user", content: "..." }],
@@ -115,7 +141,7 @@ const mixtral = await ctx.integrations.fireworks.apiRequest(
 const qwen = await ctx.integrations.fireworks.apiRequest(
   {
     method: "POST",
-    path: "/inference/v1/chat/completions",
+    path: "/v1/chat/completions",
     body: {
       model: "accounts/fireworks/models/qwen2p5-coder-32b-instruct",
       messages: [{ role: "user", content: "Write code..." }],
@@ -147,7 +173,7 @@ const EmbeddingsResponseSchema = z.object({
 const result = await ctx.integrations.fireworks.apiRequest(
   {
     method: "POST",
-    path: "/inference/v1/embeddings",
+    path: "/v1/embeddings",
     body: {
       model: "accounts/fireworks/models/nomic-embed-text-v1.5",
       input: ["Hello world", "How are you?"],
@@ -188,7 +214,7 @@ const FunctionCallResponseSchema = z.object({
 const result = await ctx.integrations.fireworks.apiRequest(
   {
     method: "POST",
-    path: "/inference/v1/chat/completions",
+    path: "/v1/chat/completions",
     body: {
       model: "accounts/fireworks/models/firefunction-v2",
       messages: [{ role: "user", content: "What's the weather in Paris?" }],
@@ -220,7 +246,7 @@ const result = await ctx.integrations.fireworks.apiRequest(
 const result = await ctx.integrations.fireworks.apiRequest(
   {
     method: "POST",
-    path: "/inference/v1/chat/completions",
+    path: "/v1/chat/completions",
     body: {
       model: "accounts/fireworks/models/llama-v3p1-70b-instruct",
       messages: [{ role: "user", content: "List 3 colors in JSON format" }],
@@ -239,7 +265,7 @@ const data = JSON.parse(result.choices[0]?.message.content ?? "{}");
 const result = await ctx.integrations.fireworks.apiRequest(
   {
     method: "POST",
-    path: "/inference/v1/chat/completions",
+    path: "/v1/chat/completions",
     body: {
       model: "accounts/fireworks/models/llama-v3p1-70b-instruct",
       messages: [{ role: "user", content: "Generate user data" }],
@@ -276,7 +302,7 @@ await fireworks.complete({ ... });
 
 // CORRECT - Use apiRequest
 await ctx.integrations.fireworks.apiRequest(
-  { method: "POST", path: "/inference/v1/chat/completions", body: { ... } },
+  { method: "POST", path: "/v1/chat/completions", body: { ... } },
   { response: ChatCompletionResponseSchema }
 );
 ```
@@ -301,18 +327,18 @@ const body = {
 
 ### API Path
 
-Fireworks uses `/inference/v1/` prefix:
+The integration's base URL already includes `https://api.fireworks.ai/inference`, so paths should start with `/v1/`:
 
 ```typescript
-// WRONG - Missing inference prefix
+// WRONG - Duplicates the /inference prefix (base URL already includes it)
 await ctx.integrations.fireworks.apiRequest(
-  { method: "POST", path: "/v1/chat/completions", body: { ... } },
+  { method: "POST", path: "/inference/v1/chat/completions", body: { ... } },
   { response: schema }
 );
 
-// CORRECT - Include inference prefix
+// CORRECT - Start with /v1/ (the integration prepends /inference automatically)
 await ctx.integrations.fireworks.apiRequest(
-  { method: "POST", path: "/inference/v1/chat/completions", body: { ... } },
+  { method: "POST", path: "/v1/chat/completions", body: { ... } },
   { response: schema }
 );
 ```
@@ -347,7 +373,7 @@ import { RestApiValidationError } from "@superblocksteam/sdk-api";
 
 try {
   const result = await ctx.integrations.fireworks.apiRequest(
-    { method: "POST", path: "/inference/v1/chat/completions", body: { ... } },
+    { method: "POST", path: "/v1/chat/completions", body: { ... } },
     { response: ChatCompletionResponseSchema }
   );
 } catch (error) {

package/src/integrations/googleanalytics/README.md

@@ -13,7 +13,7 @@ Run reports, get real-time data, and interact with Google Analytics 4 properties
 ### Run a Report
 
 ```typescript
-import { api, z, googleanalytics } from "@superblocksteam/sdk-api";
+import { api, z, googleAnalytics } from "@superblocksteam/sdk-api";
 
 // Integration ID from the integrations panel
 const PROD_GA4 = "a1b2c3d4-5678-90ab-cdef-ga4000000001";
@@ -46,7 +46,7 @@ const ReportResponseSchema = z.object({
 
 export default api({
   integrations: {
-    ga: googleanalytics(PROD_GA4),
+    ga: googleAnalytics(PROD_GA4),
   },
   name: "GoogleAnalyticsExample",
   input: z.object({

package/src/integrations/googledrive/README.md

@@ -13,7 +13,7 @@ Upload, download, and manage files in Google Drive.
 ### List Files
 
 ```typescript
-import { api, z, googledrive } from "@superblocksteam/sdk-api";
+import { api, z, googleDrive } from "@superblocksteam/sdk-api";
 
 // Integration ID from the integrations panel
 const PROD_DRIVE = "a1b2c3d4-5678-90ab-cdef-gdrive000001";
@@ -45,7 +45,7 @@ const ListFilesResponseSchema = z.object({
 
 export default api({
   integrations: {
-    drive: googledrive(PROD_DRIVE),
+    drive: googleDrive(PROD_DRIVE),
   },
   name: "GoogleDriveExample",
   input: z.object({