@superblocksteam/sdk-api 2.0.99 → 2.0.100-next.0

package/src/integrations/declarations.ts

@@ -94,6 +94,7 @@ import type { SuperblocksOCRClient } from "./superblocks-ocr/index.js";
 import type { LakebaseClient } from "./lakebase/index.js";
 import type { SnowflakePostgresClient } from "./snowflakepostgres/index.js";
 import type { SmtpClient } from "./smtp/index.js";
+import type { RestApiIntegrationPluginClient } from "./restapiintegration/index.js";
 import type { PythonClient } from "./python/index.js";
 
 // -----------------------------------------------------------------------------
@@ -125,14 +126,20 @@ export interface IntegrationRef<TPluginId extends string, TClient> {
   readonly __clientType?: TClient;
 }
 
+/**
+ * Rejects the broad `string` type while still accepting string literal types.
+ * This keeps integration IDs statically analyzable by the build pipeline.
+ */
+type LiteralString<T extends string> = string extends T ? never : T;
+
 /**
  * Helper function to create an integration reference.
  *
  * @internal
  */
-function createRef<TPluginId extends string, TClient>(
+function createRef<TPluginId extends string, TClient, TId extends string>(
   pluginId: TPluginId,
-  id: string,
+  id: LiteralString<TId>,
 ): IntegrationRef<TPluginId, TClient> {
   return { pluginId, id };
 }
@@ -357,6 +364,12 @@ export type SnowflakePostgresRef = IntegrationRef<
 /** Reference to an SMTP integration */
 export type SmtpRef = IntegrationRef<"smtp", SmtpClient>;
 
+/** Reference to a REST API Integration */
+export type RestApiIntegrationRef = IntegrationRef<
+  "restapiintegration",
+  RestApiIntegrationPluginClient
+>;
+
 // -----------------------------------------------------------------------------
 // Declaration Functions
 // -----------------------------------------------------------------------------
@@ -390,8 +403,8 @@ export type SmtpRef = IntegrationRef<"smtp", SmtpClient>;
  * });
  * ```
  */
-export function postgres(id: string): PostgresRef {
-  return createRef<"postgres", PostgresClient>("postgres", id);
+export function postgres<T extends string>(id: LiteralString<T>): PostgresRef {
+  return createRef<"postgres", PostgresClient, T>("postgres", id);
 }
 
 /**
@@ -422,8 +435,8 @@ export function postgres(id: string): PostgresRef {
  * });
  * ```
  */
-export function slack(id: string): SlackRef {
-  return createRef<"slack", SlackClient>("slack", id);
+export function slack<T extends string>(id: LiteralString<T>): SlackRef {
+  return createRef<"slack", SlackClient, T>("slack", id);
 }
 
 /**
@@ -432,8 +445,8 @@ export function slack(id: string): SlackRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function openai(id: string): OpenAIRef {
-  return createRef<"openai_v2", OpenAIClient>("openai_v2", id);
+export function openai<T extends string>(id: LiteralString<T>): OpenAIRef {
+  return createRef<"openai_v2", OpenAIClient, T>("openai_v2", id);
 }
 
 /**
@@ -442,8 +455,10 @@ export function openai(id: string): OpenAIRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function anthropic(id: string): AnthropicRef {
-  return createRef<"anthropic", AnthropicClient>("anthropic", id);
+export function anthropic<T extends string>(
+  id: LiteralString<T>,
+): AnthropicRef {
+  return createRef<"anthropic", AnthropicClient, T>("anthropic", id);
 }
 
 /**
@@ -452,8 +467,8 @@ export function anthropic(id: string): AnthropicRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function stripe(id: string): StripeRef {
-  return createRef<"stripe", StripeClient>("stripe", id);
+export function stripe<T extends string>(id: LiteralString<T>): StripeRef {
+  return createRef<"stripe", StripeClient, T>("stripe", id);
 }
 
 /**
@@ -462,8 +477,8 @@ export function stripe(id: string): StripeRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function github(id: string): GitHubRef {
-  return createRef<"github", GitHubClient>("github", id);
+export function github<T extends string>(id: LiteralString<T>): GitHubRef {
+  return createRef<"github", GitHubClient, T>("github", id);
 }
 
 /**
@@ -472,8 +487,8 @@ export function github(id: string): GitHubRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function notion(id: string): NotionRef {
-  return createRef<"notion", NotionClient>("notion", id);
+export function notion<T extends string>(id: LiteralString<T>): NotionRef {
+  return createRef<"notion", NotionClient, T>("notion", id);
 }
 
 /**
@@ -482,8 +497,10 @@ export function notion(id: string): NotionRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function snowflake(id: string): SnowflakeRef {
-  return createRef<"snowflake", SnowflakeClient>("snowflake", id);
+export function snowflake<T extends string>(
+  id: LiteralString<T>,
+): SnowflakeRef {
+  return createRef<"snowflake", SnowflakeClient, T>("snowflake", id);
 }
 
 /**
@@ -492,8 +509,10 @@ export function snowflake(id: string): SnowflakeRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function snowflakeCortex(id: string): SnowflakeCortexRef {
-  return createRef<"snowflakecortex", SnowflakeCortexClient>(
+export function snowflakeCortex<T extends string>(
+  id: LiteralString<T>,
+): SnowflakeCortexRef {
+  return createRef<"snowflakecortex", SnowflakeCortexClient, T>(
     "snowflakecortex",
     id,
   );
@@ -505,8 +524,8 @@ export function snowflakeCortex(id: string): SnowflakeCortexRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function airtable(id: string): AirtableRef {
-  return createRef<"airtable", AirtableClient>("airtable", id);
+export function airtable<T extends string>(id: LiteralString<T>): AirtableRef {
+  return createRef<"airtable", AirtableClient, T>("airtable", id);
 }
 
 /**
@@ -515,8 +534,8 @@ export function airtable(id: string): AirtableRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function asana(id: string): AsanaRef {
-  return createRef<"asana", AsanaClient>("asana", id);
+export function asana<T extends string>(id: LiteralString<T>): AsanaRef {
+  return createRef<"asana", AsanaClient, T>("asana", id);
 }
 
 /**
@@ -525,8 +544,10 @@ export function asana(id: string): AsanaRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function bitbucket(id: string): BitbucketRef {
-  return createRef<"bitbucket", BitbucketClient>("bitbucket", id);
+export function bitbucket<T extends string>(
+  id: LiteralString<T>,
+): BitbucketRef {
+  return createRef<"bitbucket", BitbucketClient, T>("bitbucket", id);
 }
 
 /**
@@ -535,8 +556,8 @@ export function bitbucket(id: string): BitbucketRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function box(id: string): BoxRef {
-  return createRef<"box", BoxClient>("box", id);
+export function box<T extends string>(id: LiteralString<T>): BoxRef {
+  return createRef<"box", BoxClient, T>("box", id);
 }
 
 /**
@@ -545,8 +566,8 @@ export function box(id: string): BoxRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function circleci(id: string): CircleCIRef {
-  return createRef<"circleci", CircleCIClient>("circleci", id);
+export function circleci<T extends string>(id: LiteralString<T>): CircleCIRef {
+  return createRef<"circleci", CircleCIClient, T>("circleci", id);
 }
 
 /**
@@ -555,8 +576,8 @@ export function circleci(id: string): CircleCIRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function cohere(id: string): CohereRef {
-  return createRef<"cohere", CohereClient>("cohere", id);
+export function cohere<T extends string>(id: LiteralString<T>): CohereRef {
+  return createRef<"cohere", CohereClient, T>("cohere", id);
 }
 
 /**
@@ -565,8 +586,10 @@ export function cohere(id: string): CohereRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function confluence(id: string): ConfluenceRef {
-  return createRef<"confluence", ConfluenceClient>("confluence", id);
+export function confluence<T extends string>(
+  id: LiteralString<T>,
+): ConfluenceRef {
+  return createRef<"confluence", ConfluenceClient, T>("confluence", id);
 }
 
 /**
@@ -575,8 +598,8 @@ export function confluence(id: string): ConfluenceRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function datadog(id: string): DatadogRef {
-  return createRef<"datadog", DatadogClient>("datadog", id);
+export function datadog<T extends string>(id: LiteralString<T>): DatadogRef {
+  return createRef<"datadog", DatadogClient, T>("datadog", id);
 }
 
 /**
@@ -585,8 +608,8 @@ export function datadog(id: string): DatadogRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function dropbox(id: string): DropboxRef {
-  return createRef<"dropbox", DropboxClient>("dropbox", id);
+export function dropbox<T extends string>(id: LiteralString<T>): DropboxRef {
+  return createRef<"dropbox", DropboxClient, T>("dropbox", id);
 }
 
 /**
@@ -595,8 +618,13 @@ export function dropbox(id: string): DropboxRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function elasticsearch(id: string): ElasticSearchRef {
-  return createRef<"elasticsearch", ElasticSearchClient>("elasticsearch", id);
+export function elasticsearch<T extends string>(
+  id: LiteralString<T>,
+): ElasticSearchRef {
+  return createRef<"elasticsearch", ElasticSearchClient, T>(
+    "elasticsearch",
+    id,
+  );
 }
 
 /**
@@ -605,8 +633,10 @@ export function elasticsearch(id: string): ElasticSearchRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function fireworks(id: string): FireworksRef {
-  return createRef<"fireworks", FireworksClient>("fireworks", id);
+export function fireworks<T extends string>(
+  id: LiteralString<T>,
+): FireworksRef {
+  return createRef<"fireworks", FireworksClient, T>("fireworks", id);
 }
 
 /**
@@ -615,8 +645,8 @@ export function fireworks(id: string): FireworksRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function front(id: string): FrontRef {
-  return createRef<"front", FrontClient>("front", id);
+export function front<T extends string>(id: LiteralString<T>): FrontRef {
+  return createRef<"front", FrontClient, T>("front", id);
 }
 
 /**
@@ -625,8 +655,8 @@ export function front(id: string): FrontRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function gemini(id: string): GeminiRef {
-  return createRef<"gemini", GeminiClient>("gemini", id);
+export function gemini<T extends string>(id: LiteralString<T>): GeminiRef {
+  return createRef<"gemini", GeminiClient, T>("gemini", id);
 }
 
 /**
@@ -635,8 +665,10 @@ export function gemini(id: string): GeminiRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function googleAnalytics(id: string): GoogleAnalyticsRef {
-  return createRef<"googleanalytics", GoogleAnalyticsClient>(
+export function googleAnalytics<T extends string>(
+  id: LiteralString<T>,
+): GoogleAnalyticsRef {
+  return createRef<"googleanalytics", GoogleAnalyticsClient, T>(
     "googleanalytics",
     id,
   );
@@ -648,8 +680,10 @@ export function googleAnalytics(id: string): GoogleAnalyticsRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function googleDrive(id: string): GoogleDriveRef {
-  return createRef<"googledrive", GoogleDriveClient>("googledrive", id);
+export function googleDrive<T extends string>(
+  id: LiteralString<T>,
+): GoogleDriveRef {
+  return createRef<"googledrive", GoogleDriveClient, T>("googledrive", id);
 }
 
 /**
@@ -658,8 +692,8 @@ export function googleDrive(id: string): GoogleDriveRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function groq(id: string): GroqRef {
-  return createRef<"groq", GroqClient>("groq", id);
+export function groq<T extends string>(id: LiteralString<T>): GroqRef {
+  return createRef<"groq", GroqClient, T>("groq", id);
 }
 
 /**
@@ -668,8 +702,8 @@ export function groq(id: string): GroqRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function hubspot(id: string): HubSpotRef {
-  return createRef<"hubspot", HubSpotClient>("hubspot", id);
+export function hubspot<T extends string>(id: LiteralString<T>): HubSpotRef {
+  return createRef<"hubspot", HubSpotClient, T>("hubspot", id);
 }
 
 /**
@@ -678,8 +712,8 @@ export function hubspot(id: string): HubSpotRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function intercom(id: string): IntercomRef {
-  return createRef<"intercom", IntercomClient>("intercom", id);
+export function intercom<T extends string>(id: LiteralString<T>): IntercomRef {
+  return createRef<"intercom", IntercomClient, T>("intercom", id);
 }
 
 /**
@@ -688,8 +722,8 @@ export function intercom(id: string): IntercomRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function jira(id: string): JiraRef {
-  return createRef<"jira", JiraClient>("jira", id);
+export function jira<T extends string>(id: LiteralString<T>): JiraRef {
+  return createRef<"jira", JiraClient, T>("jira", id);
 }
 
 /**
@@ -698,8 +732,10 @@ export function jira(id: string): JiraRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function launchDarkly(id: string): LaunchDarklyRef {
-  return createRef<"launchdarkly", LaunchDarklyClient>("launchdarkly", id);
+export function launchDarkly<T extends string>(
+  id: LiteralString<T>,
+): LaunchDarklyRef {
+  return createRef<"launchdarkly", LaunchDarklyClient, T>("launchdarkly", id);
 }
 
 /**
@@ -708,8 +744,8 @@ export function launchDarkly(id: string): LaunchDarklyRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function mistral(id: string): MistralRef {
-  return createRef<"mistral", MistralClient>("mistral", id);
+export function mistral<T extends string>(id: LiteralString<T>): MistralRef {
+  return createRef<"mistral", MistralClient, T>("mistral", id);
 }
 
 /**
@@ -718,8 +754,10 @@ export function mistral(id: string): MistralRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function pagerDuty(id: string): PagerDutyRef {
-  return createRef<"pagerduty", PagerDutyClient>("pagerduty", id);
+export function pagerDuty<T extends string>(
+  id: LiteralString<T>,
+): PagerDutyRef {
+  return createRef<"pagerduty", PagerDutyClient, T>("pagerduty", id);
 }
 
 /**
@@ -728,8 +766,10 @@ export function pagerDuty(id: string): PagerDutyRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function perplexity(id: string): PerplexityRef {
-  return createRef<"perplexity", PerplexityClient>("perplexity", id);
+export function perplexity<T extends string>(
+  id: LiteralString<T>,
+): PerplexityRef {
+  return createRef<"perplexity", PerplexityClient, T>("perplexity", id);
 }
 
 /**
@@ -738,8 +778,8 @@ export function perplexity(id: string): PerplexityRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function segment(id: string): SegmentRef {
-  return createRef<"segment", SegmentClient>("segment", id);
+export function segment<T extends string>(id: LiteralString<T>): SegmentRef {
+  return createRef<"segment", SegmentClient, T>("segment", id);
 }
 
 /**
@@ -748,8 +788,8 @@ export function segment(id: string): SegmentRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function sendGrid(id: string): SendGridRef {
-  return createRef<"sendgrid", SendGridClient>("sendgrid", id);
+export function sendGrid<T extends string>(id: LiteralString<T>): SendGridRef {
+  return createRef<"sendgrid", SendGridClient, T>("sendgrid", id);
 }
 
 /**
@@ -758,8 +798,10 @@ export function sendGrid(id: string): SendGridRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function stabilityAI(id: string): StabilityAIRef {
-  return createRef<"stabilityai", StabilityAIClient>("stabilityai", id);
+export function stabilityAI<T extends string>(
+  id: LiteralString<T>,
+): StabilityAIRef {
+  return createRef<"stabilityai", StabilityAIClient, T>("stabilityai", id);
 }
 
 /**
@@ -768,8 +810,8 @@ export function stabilityAI(id: string): StabilityAIRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function twilio(id: string): TwilioRef {
-  return createRef<"twilio", TwilioClient>("twilio", id);
+export function twilio<T extends string>(id: LiteralString<T>): TwilioRef {
+  return createRef<"twilio", TwilioClient, T>("twilio", id);
 }
 
 /**
@@ -778,8 +820,8 @@ export function twilio(id: string): TwilioRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function zendesk(id: string): ZendeskRef {
-  return createRef<"zendesk", ZendeskClient>("zendesk", id);
+export function zendesk<T extends string>(id: LiteralString<T>): ZendeskRef {
+  return createRef<"zendesk", ZendeskClient, T>("zendesk", id);
 }
 
 /**
@@ -788,8 +830,8 @@ export function zendesk(id: string): ZendeskRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function zoom(id: string): ZoomRef {
-  return createRef<"zoom", ZoomClient>("zoom", id);
+export function zoom<T extends string>(id: LiteralString<T>): ZoomRef {
+  return createRef<"zoom", ZoomClient, T>("zoom", id);
 }
 
 /**
@@ -798,8 +840,8 @@ export function zoom(id: string): ZoomRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function graphql(id: string): GraphQLRef {
-  return createRef<"graphqlintegration", GraphQLClient>(
+export function graphql<T extends string>(id: LiteralString<T>): GraphQLRef {
+  return createRef<"graphqlintegration", GraphQLClient, T>(
     "graphqlintegration",
     id,
   );
@@ -811,8 +853,8 @@ export function graphql(id: string): GraphQLRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function mysql(id: string): MySQLRef {
-  return createRef<"mysql", MySQLClient>("mysql", id);
+export function mysql<T extends string>(id: LiteralString<T>): MySQLRef {
+  return createRef<"mysql", MySQLClient, T>("mysql", id);
 }
 
 /**
@@ -821,8 +863,8 @@ export function mysql(id: string): MySQLRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function mariadb(id: string): MariaDBRef {
-  return createRef<"mariadb", MariaDBClient>("mariadb", id);
+export function mariadb<T extends string>(id: LiteralString<T>): MariaDBRef {
+  return createRef<"mariadb", MariaDBClient, T>("mariadb", id);
 }
 
 /**
@@ -831,8 +873,8 @@ export function mariadb(id: string): MariaDBRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function mssql(id: string): MSSQLRef {
-  return createRef<"mssql", MSSQLClient>("mssql", id);
+export function mssql<T extends string>(id: LiteralString<T>): MSSQLRef {
+  return createRef<"mssql", MSSQLClient, T>("mssql", id);
 }
 
 /**
@@ -841,8 +883,10 @@ export function mssql(id: string): MSSQLRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function cockroachdb(id: string): CockroachDBRef {
-  return createRef<"cockroachdb", CockroachDBClient>("cockroachdb", id);
+export function cockroachdb<T extends string>(
+  id: LiteralString<T>,
+): CockroachDBRef {
+  return createRef<"cockroachdb", CockroachDBClient, T>("cockroachdb", id);
 }
 
 /**
@@ -851,8 +895,8 @@ export function cockroachdb(id: string): CockroachDBRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function oracledb(id: string): OracleDBRef {
-  return createRef<"oracledb", OracleDBClient>("oracledb", id);
+export function oracledb<T extends string>(id: LiteralString<T>): OracleDBRef {
+  return createRef<"oracledb", OracleDBClient, T>("oracledb", id);
 }
 
 /**
@@ -861,8 +905,8 @@ export function oracledb(id: string): OracleDBRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function redshift(id: string): RedshiftRef {
-  return createRef<"redshift", RedshiftClient>("redshift", id);
+export function redshift<T extends string>(id: LiteralString<T>): RedshiftRef {
+  return createRef<"redshift", RedshiftClient, T>("redshift", id);
 }
 
 /**
@@ -871,8 +915,8 @@ export function redshift(id: string): RedshiftRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function athena(id: string): AthenaRef {
-  return createRef<"athena", AthenaClient>("athena", id);
+export function athena<T extends string>(id: LiteralString<T>): AthenaRef {
+  return createRef<"athena", AthenaClient, T>("athena", id);
 }
 
 /**
@@ -881,8 +925,10 @@ export function athena(id: string): AthenaRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function databricks(id: string): DatabricksRef {
-  return createRef<"databricks", DatabricksClient>("databricks", id);
+export function databricks<T extends string>(
+  id: LiteralString<T>,
+): DatabricksRef {
+  return createRef<"databricks", DatabricksClient, T>("databricks", id);
 }
 
 /**
@@ -891,8 +937,8 @@ export function databricks(id: string): DatabricksRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function bigquery(id: string): BigQueryRef {
-  return createRef<"bigquery", BigQueryClient>("bigquery", id);
+export function bigquery<T extends string>(id: LiteralString<T>): BigQueryRef {
+  return createRef<"bigquery", BigQueryClient, T>("bigquery", id);
 }
 
 /**
@@ -901,8 +947,8 @@ export function bigquery(id: string): BigQueryRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function mongodb(id: string): MongoDBRef {
-  return createRef<"mongodb", MongoDBClient>("mongodb", id);
+export function mongodb<T extends string>(id: LiteralString<T>): MongoDBRef {
+  return createRef<"mongodb", MongoDBClient, T>("mongodb", id);
 }
 
 /**
@@ -911,8 +957,8 @@ export function mongodb(id: string): MongoDBRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function dynamodb(id: string): DynamoDBRef {
-  return createRef<"dynamodb", DynamoDBClient>("dynamodb", id);
+export function dynamodb<T extends string>(id: LiteralString<T>): DynamoDBRef {
+  return createRef<"dynamodb", DynamoDBClient, T>("dynamodb", id);
 }
 
 /**
@@ -921,8 +967,8 @@ export function dynamodb(id: string): DynamoDBRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function cosmosdb(id: string): CosmosDBRef {
-  return createRef<"cosmosdb", CosmosDBClient>("cosmosdb", id);
+export function cosmosdb<T extends string>(id: LiteralString<T>): CosmosDBRef {
+  return createRef<"cosmosdb", CosmosDBClient, T>("cosmosdb", id);
 }
 
 /**
@@ -931,8 +977,10 @@ export function cosmosdb(id: string): CosmosDBRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function couchbase(id: string): CouchbaseRef {
-  return createRef<"couchbase", CouchbaseClient>("couchbase", id);
+export function couchbase<T extends string>(
+  id: LiteralString<T>,
+): CouchbaseRef {
+  return createRef<"couchbase", CouchbaseClient, T>("couchbase", id);
 }
 
 /**
@@ -941,8 +989,8 @@ export function couchbase(id: string): CouchbaseRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function s3(id: string): S3Ref {
-  return createRef<"s3", S3Client>("s3", id);
+export function s3<T extends string>(id: LiteralString<T>): S3Ref {
+  return createRef<"s3", S3Client, T>("s3", id);
 }
 
 /**
@@ -951,8 +999,8 @@ export function s3(id: string): S3Ref {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function gcs(id: string): GCSRef {
-  return createRef<"gcs", GCSClient>("gcs", id);
+export function gcs<T extends string>(id: LiteralString<T>): GCSRef {
+  return createRef<"gcs", GCSClient, T>("gcs", id);
 }
 
 /**
@@ -961,8 +1009,10 @@ export function gcs(id: string): GCSRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function googleSheets(id: string): GoogleSheetsRef {
-  return createRef<"gsheets", GoogleSheetsClient>("gsheets", id);
+export function googleSheets<T extends string>(
+  id: LiteralString<T>,
+): GoogleSheetsRef {
+  return createRef<"gsheets", GoogleSheetsClient, T>("gsheets", id);
 }
 
 /**
@@ -971,8 +1021,8 @@ export function googleSheets(id: string): GoogleSheetsRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function kafka(id: string): KafkaRef {
-  return createRef<"kafka", KafkaClient>("kafka", id);
+export function kafka<T extends string>(id: LiteralString<T>): KafkaRef {
+  return createRef<"kafka", KafkaClient, T>("kafka", id);
 }
 
 /**
@@ -981,8 +1031,8 @@ export function kafka(id: string): KafkaRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function kinesis(id: string): KinesisRef {
-  return createRef<"kinesis", KinesisClient>("kinesis", id);
+export function kinesis<T extends string>(id: LiteralString<T>): KinesisRef {
+  return createRef<"kinesis", KinesisClient, T>("kinesis", id);
 }
 
 /**
@@ -991,8 +1041,10 @@ export function kinesis(id: string): KinesisRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function salesforce(id: string): SalesforceRef {
-  return createRef<"salesforce", SalesforceClient>("salesforce", id);
+export function salesforce<T extends string>(
+  id: LiteralString<T>,
+): SalesforceRef {
+  return createRef<"salesforce", SalesforceClient, T>("salesforce", id);
 }
 
 /**
@@ -1001,8 +1053,8 @@ export function salesforce(id: string): SalesforceRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function redis(id: string): RedisRef {
-  return createRef<"redis", RedisClient>("redis", id);
+export function redis<T extends string>(id: LiteralString<T>): RedisRef {
+  return createRef<"redis", RedisClient, T>("redis", id);
 }
 
 /**
@@ -1011,8 +1063,10 @@ export function redis(id: string): RedisRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function superblocksOcr(id: string): SuperblocksOCRRef {
-  return createRef<"superblocks-ocr", SuperblocksOCRClient>(
+export function superblocksOcr<T extends string>(
+  id: LiteralString<T>,
+): SuperblocksOCRRef {
+  return createRef<"superblocks-ocr", SuperblocksOCRClient, T>(
     "superblocks-ocr",
     id,
   );
@@ -1024,8 +1078,8 @@ export function superblocksOcr(id: string): SuperblocksOCRRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function python(id: string): PythonRef {
-  return createRef<"python", PythonClient>("python", id);
+export function python<T extends string>(id: LiteralString<T>): PythonRef {
+  return createRef<"python", PythonClient, T>("python", id);
 }
 
 /**
@@ -1034,8 +1088,10 @@ export function python(id: string): PythonRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function confluent(id: string): ConfluentRef {
-  return createRef<"confluent", KafkaClient>("confluent", id);
+export function confluent<T extends string>(
+  id: LiteralString<T>,
+): ConfluentRef {
+  return createRef<"confluent", KafkaClient, T>("confluent", id);
 }
 
 /**
@@ -1044,8 +1100,8 @@ export function confluent(id: string): ConfluentRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function redpanda(id: string): RedpandaRef {
-  return createRef<"redpanda", KafkaClient>("redpanda", id);
+export function redpanda<T extends string>(id: LiteralString<T>): RedpandaRef {
+  return createRef<"redpanda", KafkaClient, T>("redpanda", id);
 }
 
 /**
@@ -1054,8 +1110,8 @@ export function redpanda(id: string): RedpandaRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function lakebase(id: string): LakebaseRef {
-  return createRef<"lakebase", LakebaseClient>("lakebase", id);
+export function lakebase<T extends string>(id: LiteralString<T>): LakebaseRef {
+  return createRef<"lakebase", LakebaseClient, T>("lakebase", id);
 }
 
 /**
@@ -1064,8 +1120,10 @@ export function lakebase(id: string): LakebaseRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function snowflakePostgres(id: string): SnowflakePostgresRef {
-  return createRef<"snowflakepostgres", SnowflakePostgresClient>(
+export function snowflakePostgres<T extends string>(
+  id: LiteralString<T>,
+): SnowflakePostgresRef {
+  return createRef<"snowflakepostgres", SnowflakePostgresClient, T>(
     "snowflakepostgres",
     id,
   );
@@ -1077,8 +1135,47 @@ export function snowflakePostgres(id: string): SnowflakePostgresRef {
  * @param id - The integration ID (UUID)
  * @returns An integration reference for use in the API config
  */
-export function smtp(id: string): SmtpRef {
-  return createRef<"smtp", SmtpClient>("smtp", id);
+export function smtp<T extends string>(id: LiteralString<T>): SmtpRef {
+  return createRef<"smtp", SmtpClient, T>("smtp", id);
+}
+
+/**
+ * Declare a REST API Integration.
+ *
+ * Use this for REST API Integrations configured with a base URL and
+ * authentication in the integrations page.
+ *
+ * @param id - The integration ID (UUID)
+ * @returns An integration reference for use in the API config
+ *
+ * @example
+ * ```typescript
+ * import { api, z, restApiIntegration } from '@superblocksteam/sdk-api';
+ *
+ * const MY_API = 'a1b2c3d4-uuid';
+ *
+ * export default api({
+ *   integrations: {
+ *     myApi: restApiIntegration(MY_API),
+ *   },
+ *   output: z.object({ users: z.array(z.unknown()) }),
+ *   async run(ctx) {
+ *     const users = await ctx.integrations.myApi.apiRequest(
+ *       { method: 'GET', path: '/users' },
+ *       { response: z.object({ users: z.array(z.unknown()) }) },
+ *     );
+ *     return users;
+ *   },
+ * });
+ * ```
+ */
+export function restApiIntegration<T extends string>(
+  id: LiteralString<T>,
+): RestApiIntegrationRef {
+  return createRef<"restapiintegration", RestApiIntegrationPluginClient, T>(
+    "restapiintegration",
+    id,
+  );
 }
 
 // -----------------------------------------------------------------------------