@superblocksteam/shared 0.9576.2 → 0.9577.0

package/src/plugins/templates/kinesis.ts

@@ -1,5 +1,5 @@
 import { FormItem, EditorLanguage, FormComponentType, InputDataType, Plugin, PluginResponseType, PluginType } from '../../types/index.js';
-import { PUBLIC_INTEGRATIONS_LOGO_URL, DOCS_BASE_URL } from './constants.js';
+import { PUBLIC_INTEGRATIONS_LOGO_URL } from './constants.js';
 
 const KinesisPluginVersions = {
   V1: '0.0.1'
@@ -108,7 +108,8 @@ export const KinesisPlugin: Plugin = {
   moduleName: KINESIS_MODULE_NAME,
   modulePath: 'plugins/kinesis/KinesisPlugin',
   iconLocation: `${PUBLIC_INTEGRATIONS_LOGO_URL}/kinesis.png`,
-  docsUrl: `${DOCS_BASE_URL}/kinesis`,
+  // TODO(docs-v2): no kinesis page exists in docs-v2; add one or remove this line
+  docsUrl: undefined,
   type: PluginType.API,
   responseType: PluginResponseType.JSON,
   hasRawRequest: false,

package/src/plugins/templates/openai_v2.ts

@@ -1,10 +1,11 @@
 import { ExtendedIntegrationPluginId, Plugin } from '../../types/index.js';
-import { PUBLIC_INTEGRATIONS_LOGO_URL, PUBLIC_INTEGRATIONS_CDN_URL } from './constants.js';
+import { DOCS_BASE_URL, PUBLIC_INTEGRATIONS_CDN_URL, PUBLIC_INTEGRATIONS_LOGO_URL } from './constants.js';
 import { getNativeOpenApiPlugin } from './shared/index.js';
 
 export const OpenaiV2Plugin: Plugin = getNativeOpenApiPlugin({
   name: 'OpenAI',
   id: ExtendedIntegrationPluginId.OPENAI_V2,
+  docsURL: `${DOCS_BASE_URL}/openai`,
   openApiSpecURL: `${PUBLIC_INTEGRATIONS_CDN_URL}/openapi/openai.yaml`,
   logoURL: `${PUBLIC_INTEGRATIONS_LOGO_URL}/openai_logo.png`,
   authMethods: {

package/src/plugins/templates/redis.ts

@@ -1,5 +1,5 @@
 import { FormComponentType, InputDataType, Plugin, PluginResponseType, PluginType } from '../../types/index.js';
-import { PUBLIC_INTEGRATIONS_LOGO_URL, DOCS_BASE_URL } from './constants.js';
+import { PUBLIC_INTEGRATIONS_LOGO_URL } from './constants.js';
 
 const RedisPluginVersions = {
   V1: '0.0.1'
@@ -75,11 +75,10 @@ const makeDropdownItem = (value: string, displayName?: string, subText?: string)
   };
 };
 
-// NOTE: (joey) make sure these docs are done pre-release
+// TODO(docs-v2): no redis page exists in docs-v2; add one and restore docsUrl
+export const RedisPlugin = generateRedisPlugin('redis', 'Redis', `${PUBLIC_INTEGRATIONS_LOGO_URL}/redis.png`);
 
-export const RedisPlugin = generateRedisPlugin('redis', 'Redis', `${PUBLIC_INTEGRATIONS_LOGO_URL}/redis.png`, `${DOCS_BASE_URL}/redis`);
-
-function generateRedisPlugin(id: string, name: string, iconLocation: string, docsUrl: string): Plugin {
+function generateRedisPlugin(id: string, name: string, iconLocation: string, docsUrl?: string): Plugin {
   return {
     id,
     name,

package/src/plugins/templates/restApi.ts

@@ -30,7 +30,7 @@ export const RestApiPlugin: Plugin = {
   moduleName: 'RestApiPlugin',
   modulePath: 'plugins/restApi/RestApiPlugin',
   iconLocation: `${PUBLIC_INTEGRATIONS_LOGO_URL}/restapi.png`,
-  docsUrl: `${DOCS_BASE_URL}/rest-apis`,
+  docsUrl: `${DOCS_BASE_URL}/rest-api`,
   isStreamable: true,
   type: PluginType.API,
   responseType: PluginResponseType.JSON,

package/src/plugins/templates/restApiIntegration.ts

@@ -27,7 +27,7 @@ export const RestApiIntegrationPlugin: Plugin = {
   moduleName: 'RestApiIntegrationPlugin',
   modulePath: 'plugins/restApiIntegration/RestApiIntegrationPlugin',
   iconLocation: `${PUBLIC_INTEGRATIONS_LOGO_URL}/restapi.png`,
-  docsUrl: `${DOCS_BASE_URL}/rest-apis`,
+  docsUrl: `${DOCS_BASE_URL}/rest-api`,
   isStreamable: true,
   type: PluginType.API,
   responseType: PluginResponseType.JSON,

package/src/plugins/templates/secrets/akeylessSecretsManager.ts

@@ -11,7 +11,7 @@ export const AkeylessSecretsManagerPlugin: Plugin = {
   moduleName: 'AkeylessSecretsManagerPlugin',
   modulePath: '',
   iconLocation: `${PUBLIC_INTEGRATIONS_LOGO_URL}/akeyless.png`,
-  docsUrl: 'https://docs.superblocks.com/development-lifecycle/secrets/akeyless-secrets-manager',
+  docsUrl: 'https://docs-legacy.superblocks.com/development-lifecycle/secrets/akeyless-secrets-manager',
   type: PluginType.DB,
   responseType: PluginResponseType.JSON,
   hasRawRequest: false,

package/src/plugins/templates/secrets/awsSecretsManager.ts

@@ -19,7 +19,7 @@ export const AWSSecretsManagerPlugin: Plugin = {
   moduleName: 'AWSSecretsManagerPlugin',
   modulePath: '',
   iconLocation: `${PUBLIC_INTEGRATIONS_LOGO_URL}/aws_secrets_manager.psd.png`,
-  docsUrl: 'https://docs.superblocks.com/development-lifecycle/secrets/aws-secrets-manager',
+  docsUrl: 'https://docs-legacy.superblocks.com/development-lifecycle/secrets/aws-secrets-manager',
   type: PluginType.DB,
   responseType: PluginResponseType.JSON,
   hasRawRequest: false,

package/src/plugins/templates/secrets/gcpSecretsManager.ts

@@ -20,7 +20,7 @@ export const GCPSecretsManagerPlugin: Plugin = {
   moduleName: 'GCPSecretsManagerPlugin',
   modulePath: '',
   iconLocation: `${PUBLIC_INTEGRATIONS_LOGO_URL}/secret_manager_1.png`,
-  docsUrl: 'https://docs.superblocks.com/development-lifecycle/secrets/google-secrets-manager',
+  docsUrl: 'https://docs-legacy.superblocks.com/development-lifecycle/secrets/google-secrets-manager',
   type: PluginType.DB,
   responseType: PluginResponseType.JSON,
   hasRawRequest: false,

package/src/plugins/templates/secrets/hashicorpVault.ts

@@ -11,7 +11,7 @@ export const HashicorpVaultPlugin: Plugin = {
   moduleName: 'HashicorpVaultPlugin',
   modulePath: '',
   iconLocation: `${PUBLIC_INTEGRATIONS_LOGO_URL}/hashicorpvault.png`,
-  docsUrl: 'https://docs.superblocks.com/development-lifecycle/secrets/hashicorp-vault',
+  docsUrl: 'https://docs-legacy.superblocks.com/development-lifecycle/secrets/hashicorp-vault',
   type: PluginType.DB,
   responseType: PluginResponseType.JSON,
   hasRawRequest: false,

package/src/plugins/templates/shared/auth.ts

@@ -246,7 +246,7 @@ export const authSections = ({
         {
           label: '',
           messageTemplate: `The authorization header will be automatically generated when you send requests.
-          Learn more about [Basic Auth](https://docs.superblocks.com/integrations/authentication/#basic-authentication) authorization.`,
+          Learn more about [Basic Auth](https://docs.superblocks.com/integrations/auth/authentication-types) authorization.`,
           name: 'HTTPBasicAlert',
           startVersion: startVersion,
           componentType: FormComponentType.ALERT,
@@ -496,7 +496,7 @@ export const authSections = ({
       [
         {
           label: '',
-          messageTemplate: `**Where do I get my firebase credentials and allow access to Superblocks?** [Superblocks - Firebase Docs](https://docs.superblocks.com/integrations/authenticating-apis/authenticate-using-firebase-auth)\\
+          messageTemplate: `**Where do I get my firebase credentials and allow access to Superblocks?** [Superblocks - Firebase Docs](https://docs.superblocks.com/integrations/auth/firebase)\\
   Note: REST APIs authenticated with firebase cannot be used in Superblocks Workflows & Scheduled Jobs since both can be called headlessly without user interaction.`,
           name: 'FirebaseAlert',
           startVersion: startVersion,
@@ -561,7 +561,7 @@ export const authSections = ({
           messageTemplate: `Use **{{firebase.token}}** below to refer to the firebase
       authentication token & use **{{firebase.userId}}** to refer to the
       currently authenticated user's ID.`,
-          name: 'FirebaseAlert',
+          name: 'FirebaseAlertToken',
           startVersion: startVersion,
           componentType: FormComponentType.ALERT,
           display: {
@@ -939,7 +939,7 @@ export const authSections = ({
         {
           label: '',
           messageTemplate: `Send your token to requests by adding it to a header or parameter using **\`{{ oauth.token }}\`**.
-          Learn more in our docs on [using OAuth2.0 in Superblocks](https://docs.superblocks.com/integrations/authentication/#oauth-20).`,
+          Learn more in our docs on [using OAuth2.0 in Superblocks](https://docs.superblocks.com/integrations/auth/oauth-20).`,
           name: 'OAuth2PasswordAlert',
           startVersion,
           componentType: FormComponentType.ALERT,

package/src/plugins/templates/smtp.ts

@@ -1,5 +1,5 @@
 import { FormComponentType, FormItem, InputDataType, Plugin, PluginResponseType, PluginType } from '../../types/index.js';
-import { PUBLIC_INTEGRATIONS_LOGO_URL, DOCS_BASE_URL } from './constants.js';
+import { PUBLIC_INTEGRATIONS_LOGO_URL } from './constants.js';
 
 // TODO (jason) change these constant values as these are pulled from Sendgrid
 // superblocksmail is set up as a verified domain in Sendgrid under a different account than superblockshq.com.
@@ -117,7 +117,8 @@ export const SmtpPlugin: Plugin = {
   moduleName: 'SmtpPlugin',
   modulePath: 'plugins/smtp/SmtpPlugin',
   iconLocation: `${PUBLIC_INTEGRATIONS_LOGO_URL}/smtp.png`,
-  docsUrl: `${DOCS_BASE_URL}/smtp`,
+  // TODO(docs-v2): no smtp page exists in docs-v2; add one or remove this line
+  docsUrl: undefined,
   type: PluginType.API,
   responseType: PluginResponseType.JSON,
   hasRawRequest: true,

package/src/plugins/templates/snowflakecortex.ts

@@ -1,10 +1,11 @@
 import { ExtendedIntegrationPluginId, Plugin } from '../../types/index.js';
-import { PUBLIC_INTEGRATIONS_CDN_URL, PUBLIC_INTEGRATIONS_LOGO_URL } from './constants.js';
+import { DOCS_BASE_URL, PUBLIC_INTEGRATIONS_CDN_URL, PUBLIC_INTEGRATIONS_LOGO_URL } from './constants.js';
 import { getNativeOpenApiPlugin } from './shared/index.js';
 
 export const SnowflakeCortexPlugin: Plugin = getNativeOpenApiPlugin({
   name: 'Snowflake Cortex',
   id: ExtendedIntegrationPluginId.SNOWFLAKE_CORTEX,
+  docsURL: `${DOCS_BASE_URL}/snowflake-cortex`,
   openApiSpecURL: `${PUBLIC_INTEGRATIONS_CDN_URL}/openapi/snowflake-cortex.yaml`,
   logoURL: `${PUBLIC_INTEGRATIONS_LOGO_URL}/snowflake.png`,
   authMethods: {

package/src/plugins/templates/snowflakepostgres.ts

@@ -103,7 +103,7 @@ export const SnowflakePostgresPlugin: Plugin = {
   moduleName: 'SnowflakePostgresPlugin',
   modulePath: 'plugins/snowflakepostgres/SnowflakePostgresPlugin',
   iconLocation: `${PUBLIC_INTEGRATIONS_LOGO_URL}/snowflake.png`,
-  docsUrl: `${DOCS_BASE_URL}/snowflakepostgres`,
+  docsUrl: `${DOCS_BASE_URL}/snowflake-postgres`,
   type: PluginType.DB,
   responseType: PluginResponseType.TABLE,
   hasRawRequest: true,

package/src/plugins/templates/superblocks-ocr.ts

@@ -1,5 +1,5 @@
 import { FormComponentType, Plugin, PluginResponseType, PluginType } from '../../types/index.js';
-import { PUBLIC_INTEGRATIONS_LOGO_URL, DOCS_BASE_URL } from './constants.js';
+import { PUBLIC_INTEGRATIONS_LOGO_URL } from './constants.js';
 
 const SuperblocksOcrPluginVersions = {
   V1: '0.0.1'
@@ -28,7 +28,8 @@ export const SuperblocksOcrPlugin: Plugin = {
   moduleName: 'SuperblocksOcrPlugin',
   modulePath: 'plugins/superblocks-ocr/SuperblocksOcrPlugin',
   iconLocation: `${PUBLIC_INTEGRATIONS_LOGO_URL}/ocr_logo.png`,
-  docsUrl: `${DOCS_BASE_URL}/superblocks-ocr`,
+  // TODO(docs-v2): no superblocks-ocr page exists in docs-v2; add one or remove this line
+  docsUrl: undefined,
   type: PluginType.API,
   responseType: PluginResponseType.JSON,
   hasRawRequest: true,

package/src/types/ai/quota-paywall.ts

@@ -1,4 +1,9 @@
-export type AiQuotaPaywallReason = 'credit_limit_exceeded' | 'no_seat_assigned' | 'token_limit_exceeded' | 'trial_expired';
+export type AiQuotaPaywallReason =
+  | 'credit_limit_exceeded'
+  | 'deploy_quota_exceeded'
+  | 'no_seat_assigned'
+  | 'token_limit_exceeded'
+  | 'trial_expired';
 
 export const getAiQuotaPaywallReasonFromMessage = (message: string): AiQuotaPaywallReason | undefined => {
   const normalizedMessage = message.toLowerCase();
@@ -28,6 +33,10 @@ export const getAiQuotaPaywallReasonFromMessage = (message: string): AiQuotaPayw
     return 'token_limit_exceeded';
   }
 
+  if (normalizedMessage.includes('deploy_quota_exceeded')) {
+    return 'deploy_quota_exceeded';
+  }
+
   if (normalizedMessage.includes('credit_limit_exceeded') || normalizedMessage.includes('organization has reached its ai usage limit')) {
     return 'credit_limit_exceeded';
   }
@@ -43,10 +52,7 @@ export const AI_QUOTA_PAYWALL_STRIPE_CHECKOUT_URL = 'https://buy.stripe.com/7sYe
 
 export const AI_QUOTA_PAYWALL_CONTACT_SALES_EMAIL = 'sales@superblockshq.com';
 
-// TODO: Revisit this mailto template once backend enforcement is in place.
-// Surface the specific reason (buy a seat vs. increase org credits) so the
-// email to the admin is actionable rather than generic.
-export const AI_QUOTA_PAYWALL_CONTACT_SALES_MAILTO = 'mailto:sales@superblockshq.com?subject=Enterprise%20inquiry';
+export const AI_QUOTA_PAYWALL_CONTACT_SALES_URL = 'https://www.superblocks.com/book-a-demo';
 
 export const AI_QUOTA_PAYWALL_REASON_CONFIG: Record<AiQuotaPaywallReason, { title: string; subtitle: string }> = {
   credit_limit_exceeded: {
@@ -64,6 +70,10 @@ export const AI_QUOTA_PAYWALL_REASON_CONFIG: Record<AiQuotaPaywallReason, { titl
   trial_expired: {
     title: 'Your free trial has ended',
     subtitle: 'Upgrade to keep building with AI.'
+  },
+  deploy_quota_exceeded: {
+    title: 'Deploy limit reached',
+    subtitle: 'Your organization has reached its deployed app limit. Add more deployed apps to continue.'
   }
 };
 
@@ -90,7 +100,7 @@ export const AI_QUOTA_PAYWALL_ENTERPRISE_FEATURES = [
   'Custom app hosting'
 ];
 
-export const AI_QUOTA_PAYWALL_TEAMS_PLATFORM_FEATURES = ['Staging and production environments', '1 hosted app included'];
+export const AI_QUOTA_PAYWALL_TEAMS_PLATFORM_FEATURES = ['Staging and production environments', '1 deployed app per team'];
 
 export const AI_QUOTA_PAYWALL_ENTERPRISE_PLATFORM_FEATURES = [
   'Deploy in your VPC (Hybrid or Cloud Prem)',

package/src/types/audit/audit.ts

@@ -59,7 +59,8 @@ export const ABANDONED_EXECUTION_THRESH_MINUTES = 30;
 
 /** @deprecated Use OCSFClassUid / OCSFActivityId instead. */
 export enum AuditLogEventType {
-  API_RUN
+  API_RUN,
+  INTEGRATION_QUERY
 }
 
 /** @deprecated Use OCSFAuditEvent instead. */

package/src/types/audit/ocsf.ts

@@ -212,7 +212,7 @@ export const AUDIT_EVENT_TYPE_CATALOG: AuditEventTypeEntry[] = [
     category_uid: OCSFCategoryUid.APPLICATION_ACTIVITY,
     category_name: 'APPLICATION_ACTIVITY',
     resource_type: 'Integration',
-    operations: ['integration.create', 'integration.delete', 'integration.update']
+    operations: ['integration.create', 'integration.delete', 'integration.secret.view', 'integration.update']
   },
   {
     class_uid: OCSFClassUid.ENTITY_MANAGEMENT,

package/src/types/billing/billing.ts

@@ -11,6 +11,23 @@ export enum BillingPlan {
   POC = 'POC'
 }
 
+const ENTERPRISE_LIKE_PLANS: ReadonlySet<BillingPlan> = new Set([
+  BillingPlan.ENTERPRISE,
+  BillingPlan.PRO,
+  BillingPlan.STARTER,
+  BillingPlan.POC
+]);
+
+const TRIAL_LIKE_PLANS: ReadonlySet<BillingPlan> = new Set([BillingPlan.TRIAL, BillingPlan.FREE]);
+
+export function isEnterpriseLikePlan(plan: BillingPlan | undefined | null): boolean {
+  return plan != null && ENTERPRISE_LIKE_PLANS.has(plan);
+}
+
+export function isTrialLikePlan(plan: BillingPlan | undefined | null): boolean {
+  return plan != null && TRIAL_LIKE_PLANS.has(plan);
+}
+
 export type Billing = {
   plan: BillingPlan;
   isExpired: boolean;

package/src/types/datasource/index.ts

@@ -341,6 +341,7 @@ export type RestApiDatasourceConfiguration = AuthenticatedHttpDatasourceConfig &
   // This is part of the in-memory form, not persisted
   AuthCodeExplanation?: string;
   FirebaseAlert?: string;
+  FirebaseAlertToken?: string;
   HTTPBasicAlert?: string;
   'oauth-callback-alert'?: string;
   'oauth-connect-button'?: string;

package/src/types/repository/index.ts

@@ -47,7 +47,8 @@ export type GitToken = {
 
 export enum VcsProvider {
   GITHUB = 'github',
-  GITLAB = 'gitlab'
+  GITLAB = 'gitlab',
+  AZURE_DEVOPS = 'azure_devops'
 }
 
 export type GitLabInstanceType = 'cloud' | 'self-hosted';
@@ -68,6 +69,9 @@ export const getGitProviderBaseUrl = (provider?: VcsProvider, token?: GitToken)
       if (token?.instanceUrl) return token.instanceUrl;
       return 'https://gitlab.com';
     }
+    case VcsProvider.AZURE_DEVOPS: {
+      return 'https://dev.azure.com';
+    }
     case VcsProvider.GITHUB:
     default: {
       return 'https://github.com';
@@ -77,5 +81,9 @@ export const getGitProviderBaseUrl = (provider?: VcsProvider, token?: GitToken)
 
 export const getRepositoryUrl = (repository: RepositoryDto, token?: GitToken) => {
   const baseUrl = getGitProviderBaseUrl(repository.provider, token);
+  if (repository.provider === VcsProvider.AZURE_DEVOPS) {
+    // Azure DevOps URL format: https://dev.azure.com/{organization}/{project}/_git/{repo}
+    return `${baseUrl}/${repository.owner}/_git/${repository.name}`;
+  }
   return `${baseUrl}/${repository.owner}/${repository.name}`;
 };

package/src/utils/azure-devops-workflow.ts

@@ -0,0 +1,36 @@
+import { DEFAULT_SUPERBLOCKS_DOMAIN, getSuperblocksDomainFromBaseUrl } from './github-workflow.js';
+
+export function isAzureDevOpsRemoteUrl(remoteUrl: string): boolean {
+  return /(^git@ssh\.dev\.azure\.com:)|(^https?:\/\/([^@]+@)?dev\.azure\.com\/)|(^ssh:\/\/git@ssh\.dev\.azure\.com\/)/.test(
+    remoteUrl.trim()
+  );
+}
+
+export function buildAzureDevOpsSuperblocksSyncPipeline(domain: string = DEFAULT_SUPERBLOCKS_DOMAIN): string {
+  return `trigger:
+  branches:
+    include:
+      - main
+
+pool:
+  vmImage: ubuntu-latest
+
+steps:
+  - checkout: self
+    fetchDepth: 0
+    persistCredentials: false
+
+  - task: Bash@3
+    displayName: Sync to Superblocks
+    env:
+      SUPERBLOCKS_TOKEN: $(SUPERBLOCKS_TOKEN)
+    inputs:
+      targetType: inline
+      script: |
+        npx @superblocksteam/cli sync --token "$SUPERBLOCKS_TOKEN" --domain ${domain} --path . --sha $(Build.SourceVersion)
+`;
+}
+
+export function buildAzureDevOpsSuperblocksSyncPipelineFromBaseUrl(superblocksBaseUrl: string): string {
+  return buildAzureDevOpsSuperblocksSyncPipeline(getSuperblocksDomainFromBaseUrl(superblocksBaseUrl));
+}

package/src/utils/git-url.test.ts

@@ -48,11 +48,22 @@ describe('gitRemoteUrlToWeb', () => {
     ['https://github.com/org/repo', 'https://github.com/org/repo'],
     ['http://gitlab.com/org/repo.git', 'http://gitlab.com/org/repo'],
     ['git@github.com:org/repo.git', 'https://github.com/org/repo'],
-    ['git@gitlab.com:group/sub/repo.git', 'https://gitlab.com/group/sub/repo']
+    ['git@gitlab.com:group/sub/repo.git', 'https://gitlab.com/group/sub/repo'],
+    // Azure DevOps HTTPS with userinfo (clone URL default format)
+    ['https://myorg@dev.azure.com/myorg/myproject/_git/myrepo', 'https://dev.azure.com/myorg/myproject/_git/myrepo'],
+    // Azure DevOps SSH formats
+    ['git@ssh.dev.azure.com:v3/myorg/myproject/myrepo', 'https://dev.azure.com/myorg/myproject/_git/myrepo'],
+    ['ssh://git@ssh.dev.azure.com/v3/myorg/myproject/myrepo', 'https://dev.azure.com/myorg/myproject/_git/myrepo']
   ])('converts %s → %s', (input, expected) => {
     expect(gitRemoteUrlToWeb(input)).toBe(expected);
   });
 
+  it('strips userinfo from HTTPS URLs', () => {
+    expect(gitRemoteUrlToWeb('https://myorg@dev.azure.com/myorg/myproject/_git/myrepo')).toBe(
+      'https://dev.azure.com/myorg/myproject/_git/myrepo'
+    );
+  });
+
   it('returns null for unconvertible URLs', () => {
     expect(gitRemoteUrlToWeb('not-a-url')).toBeNull();
   });

package/src/utils/git-url.ts

@@ -5,14 +5,16 @@
  * Used by both the UI and the vite-plugin-file-sync AI agent tooling.
  */
 
-const HTTPS_GIT_URL_RE = /^https?:\/\/[^\s/$.?#]+\.[^\s/$.?#]+\/[^\s/$.?#]+(\/[^\s/$.?#]+)+(\.git)?\/?$/i;
+const HTTPS_GIT_URL_RE = /^https?:\/\/[^\s/$.?#]+(?:\.[^\s/$.?#]+)+\/[^\s/$.?#]+(\/[^\s/$.?#]+)+(\.git)?\/?$/i;
 const SSH_GIT_URL_RE = /^[\w-]+@[\w.-]+:[\w./-]+(\.git)?$/;
+// ssh:// protocol format: ssh://git@host/path
+const SSH_PROTOCOL_RE = /^ssh:\/\/[\w-]+@[\w.-]+(\/[\w./-]+)+(\.git)?\/?$/i;
 
 export const GITHUB_PAT_SETTINGS_URL = 'https://github.com/settings/tokens';
 
 export function isValidGitUrl(url: string): boolean {
   const trimmed = url.trim();
-  return HTTPS_GIT_URL_RE.test(trimmed) || SSH_GIT_URL_RE.test(trimmed);
+  return HTTPS_GIT_URL_RE.test(trimmed) || SSH_GIT_URL_RE.test(trimmed) || SSH_PROTOCOL_RE.test(trimmed);
 }
 
 export function isGitHubUrl(url: string): boolean {
@@ -44,15 +46,43 @@ export function gitRemoteUrlToWeb(url: string): string | null {
   try {
     const parsed = new URL(trimmed);
     if (parsed.protocol === 'https:' || parsed.protocol === 'http:') {
-      return trimmed.replace(/\.git\s*$/, '');
+      // Strip userinfo (e.g. "org@" in Azure DevOps clone URLs) so the
+      // result is a plain browser-friendly URL.
+      parsed.username = '';
+      parsed.password = '';
+      return parsed.href.replace(/\/+$/, '').replace(/\.git\s*$/, '');
+    }
+    // ssh:// protocol format: ssh://git@host/path
+    if (parsed.protocol === 'ssh:') {
+      const host = parsed.hostname;
+      const path = parsed.pathname.replace(/\.git\s*$/, '');
+      // Azure DevOps SSH: ssh://git@ssh.dev.azure.com/v3/org/project/repo
+      if (host === 'ssh.dev.azure.com') {
+        const azureMatch = path.match(/^\/v3\/([^/]+)\/([^/]+)\/(.+?)$/);
+        if (azureMatch) {
+          return `https://dev.azure.com/${azureMatch[1]}/${azureMatch[2]}/_git/${azureMatch[3]}`;
+        }
+      }
+      // Generic ssh:// → https:// (GitHub, GitLab, etc.)
+      return `https://${host}${path}`;
     }
   } catch {
     // Not a standard URL — try SSH
   }
 
+  // SCP-style SSH: git@host:org/repo.git → https://host/org/repo
   const sshMatch = trimmed.match(/^[\w-]+@([\w.-]+):(.+?)(?:\.git)?\s*$/);
   if (sshMatch?.[1] && sshMatch[2]) {
-    return `https://${sshMatch[1]}/${sshMatch[2]}`;
+    const host = sshMatch[1];
+    const path = sshMatch[2];
+    // Azure DevOps SSH: git@ssh.dev.azure.com:v3/org/project/repo → https://dev.azure.com/org/project/_git/repo
+    if (host === 'ssh.dev.azure.com') {
+      const azureMatch = path.match(/^v3\/([^/]+)\/([^/]+)\/(.+)$/);
+      if (azureMatch) {
+        return `https://dev.azure.com/${azureMatch[1]}/${azureMatch[2]}/_git/${azureMatch[3]}`;
+      }
+    }
+    return `https://${host}/${path}`;
   }
 
   return null;
@@ -90,15 +120,17 @@ export function getGitHubCompareUrl({
   return `${base}?${params.toString()}`;
 }
 
-type GitProvider = 'github' | 'gitlab' | 'bitbucket' | 'unknown';
+export type GitProvider = 'github' | 'gitlab' | 'bitbucket' | 'azure_devops' | 'unknown';
 
-const HOST_TO_PROVIDER: Record<string, GitProvider> = {
+export const HOST_TO_PROVIDER: Record<string, GitProvider> = {
   'bitbucket.org': 'bitbucket',
+  'dev.azure.com': 'azure_devops',
   'github.com': 'github',
-  'gitlab.com': 'gitlab'
+  'gitlab.com': 'gitlab',
+  'ssh.dev.azure.com': 'azure_devops'
 };
 
-function detectGitProvider(url: string): GitProvider {
+export function detectGitProvider(url: string): GitProvider {
   const trimmed = url.trim();
 
   try {
@@ -123,6 +155,7 @@ function getCommitPathForProvider(params: { hash: string; provider: GitProvider
       return `/commits/${hash}`;
     case 'gitlab':
       return `/-/commit/${hash}`;
+    case 'azure_devops':
     case 'github':
     case 'unknown':
       return `/commit/${hash}`;

package/src/utils/pageFixtures/v6/nested_modal.ts

@@ -58,7 +58,7 @@ export default Object.freeze({
                       isVisible: true,
                       animateLoading: true,
                       isDefaultClickDisabled: true,
-                      docsUrl: 'https://docs.superblocks.com/components/button',
+                      docsUrl: 'https://docs-legacy.superblocks.com/components/button',
                       type: 'BUTTON_WIDGET',
                       widgetId: 'bbwoxnsscs',
                       isLoading: false,
@@ -90,7 +90,7 @@ export default Object.freeze({
                       isVisible: true,
                       animateLoading: true,
                       isDefaultClickDisabled: true,
-                      docsUrl: 'https://docs.superblocks.com/components/button',
+                      docsUrl: 'https://docs-legacy.superblocks.com/components/button',
                       type: 'BUTTON_WIDGET',
                       widgetId: '29zprbh4ka',
                       isLoading: false,
@@ -153,7 +153,7 @@ export default Object.freeze({
               isVisible: true,
               animateLoading: true,
               isDefaultClickDisabled: true,
-              docsUrl: 'https://docs.superblocks.com/components/button',
+              docsUrl: 'https://docs-legacy.superblocks.com/components/button',
               dynamicTriggerPathList: [
                 {
                   key: 'onClick'

package/src/utils/pageFixtures/v6/with_2_modals.ts

@@ -46,7 +46,7 @@ export default Object.freeze({
               isVisible: true,
               animateLoading: true,
               isDefaultClickDisabled: true,
-              docsUrl: 'https://docs.superblocks.com/components/button',
+              docsUrl: 'https://docs-legacy.superblocks.com/components/button',
               type: 'BUTTON_WIDGET',
               widgetId: 'h6ixkdhufq',
               isLoading: false,
@@ -78,7 +78,7 @@ export default Object.freeze({
               isVisible: true,
               animateLoading: true,
               isDefaultClickDisabled: true,
-              docsUrl: 'https://docs.superblocks.com/components/button',
+              docsUrl: 'https://docs-legacy.superblocks.com/components/button',
               type: 'BUTTON_WIDGET',
               widgetId: 'nd41xermdw',
               isLoading: false,
@@ -141,7 +141,7 @@ export default Object.freeze({
       isVisible: true,
       animateLoading: true,
       isDefaultClickDisabled: true,
-      docsUrl: 'https://docs.superblocks.com/components/button',
+      docsUrl: 'https://docs-legacy.superblocks.com/components/button',
       dynamicTriggerPathList: [
         {
           key: 'onClick'
@@ -208,7 +208,7 @@ export default Object.freeze({
               isVisible: true,
               animateLoading: true,
               isDefaultClickDisabled: true,
-              docsUrl: 'https://docs.superblocks.com/components/button',
+              docsUrl: 'https://docs-legacy.superblocks.com/components/button',
               type: 'BUTTON_WIDGET',
               widgetId: 'x5qbntpl1n',
               isLoading: false,
@@ -240,7 +240,7 @@ export default Object.freeze({
               isVisible: true,
               animateLoading: true,
               isDefaultClickDisabled: true,
-              docsUrl: 'https://docs.superblocks.com/components/button',
+              docsUrl: 'https://docs-legacy.superblocks.com/components/button',
               type: 'BUTTON_WIDGET',
               widgetId: '4f3izb5tna',
               isLoading: false,
@@ -303,7 +303,7 @@ export default Object.freeze({
       isVisible: true,
       animateLoading: true,
       isDefaultClickDisabled: true,
-      docsUrl: 'https://docs.superblocks.com/components/button',
+      docsUrl: 'https://docs-legacy.superblocks.com/components/button',
       dynamicTriggerPathList: [
         {
           key: 'onClick'

package/src/utils/pageFixtures/v6/with_slideouts.ts

@@ -164,7 +164,7 @@ export default Object.freeze({
       isVisible: true,
       animateLoading: true,
       isDefaultClickDisabled: true,
-      docsUrl: 'https://docs.superblocks.com/components/button',
+      docsUrl: 'https://docs-legacy.superblocks.com/components/button',
       dynamicTriggerPathList: [
         {
           key: 'onClick'

package/src/utils/pageFixtures/v7/canvases.ts

@@ -219,7 +219,7 @@ export default Object.freeze({
                             mode: 'gridUnit',
                             value: 3
                           },
-                          docsUrl: 'https://docs.superblocks.com/components/button',
+                          docsUrl: 'https://docs-legacy.superblocks.com/components/button',
                           onClick: [
                             {
                               id: 'b17e1cgp85',
@@ -263,7 +263,7 @@ export default Object.freeze({
                             mode: 'gridUnit',
                             value: 3
                           },
-                          docsUrl: 'https://docs.superblocks.com/components/button',
+                          docsUrl: 'https://docs-legacy.superblocks.com/components/button',
                           parentId: 'mbp6dkndpg',
                           widgetId: 'usn4tzfc45',
                           isLoading: false,