@anymux/connect 0.1.0

package/src/registry/services/bitbucket.ts

@@ -0,0 +1,24 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const bitbucketService: ServiceDefinition = {
+  id: 'bitbucket',
+  name: 'Bitbucket',
+  icon: 'GitBranch',
+  color: '#0052CC',
+  authProvider: 'bitbucket',
+  grantsUrl: 'https://bitbucket.org/account/settings/app-authorizations/',
+  capabilities: [
+    { id: 'file-system', supported: true },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: true },
+    { id: 'git-host', supported: true },
+    { id: 'media', supported: false },
+    { id: 'contacts', supported: false },
+    { id: 'calendar', supported: false },
+  ],
+  scopes: {
+    'file-system': ['repository'],
+    'git-repo': ['repository'],
+    'git-host': ['repository', 'pullrequest'],
+  },
+};

package/src/registry/services/box.ts

@@ -0,0 +1,22 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const boxService: ServiceDefinition = {
+  id: 'box',
+  name: 'Box',
+  icon: 'Box',
+  color: '#0061D5',
+  authProvider: 'box',
+  grantsUrl: 'https://app.box.com/account/security',
+  capabilities: [
+    { id: 'file-system', supported: true },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: false },
+    { id: 'git-host', supported: false },
+    { id: 'media', supported: false },
+    { id: 'contacts', supported: false },
+    { id: 'calendar', supported: false },
+  ],
+  scopes: {
+    'file-system': ['root_readwrite'],
+  },
+};

package/src/registry/services/browser-fs.ts

@@ -0,0 +1,19 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const browserFsService: ServiceDefinition = {
+  id: 'browser-fs',
+  name: 'Local Files',
+  icon: 'FolderOpen',
+  color: '#4CAF50',
+  authProvider: 'browser-fs',
+  capabilities: [
+    { id: 'file-system', supported: true },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: false },
+    { id: 'git-host', supported: false },
+    { id: 'media', supported: false },
+    { id: 'contacts', supported: false },
+    { id: 'calendar', supported: false },
+  ],
+  scopes: {},
+};

package/src/registry/services/dropbox.ts

@@ -0,0 +1,22 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const dropboxService: ServiceDefinition = {
+  id: 'dropbox',
+  name: 'Dropbox',
+  icon: 'Box',
+  color: '#0061FF',
+  authProvider: 'dropbox',
+  grantsUrl: 'https://www.dropbox.com/account/connected_apps',
+  capabilities: [
+    { id: 'file-system', supported: true },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: false },
+    { id: 'git-host', supported: false },
+    { id: 'media', supported: false },
+    { id: 'contacts', supported: false },
+    { id: 'calendar', supported: false },
+  ],
+  scopes: {
+    'file-system': ['files.metadata.read', 'files.content.read', 'files.content.write'],
+  },
+};

package/src/registry/services/flickr.ts

@@ -0,0 +1,22 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const flickrService: ServiceDefinition = {
+  id: 'flickr',
+  name: 'Flickr',
+  icon: 'Camera',
+  color: '#FF0084',
+  authProvider: 'flickr',
+  grantsUrl: 'https://www.flickr.com/auth/applications/',
+  capabilities: [
+    { id: 'file-system', supported: false },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: false },
+    { id: 'git-host', supported: false },
+    { id: 'media', supported: true },
+    { id: 'contacts', supported: false },
+    { id: 'calendar', supported: false },
+  ],
+  scopes: {
+    'media': ['read'],
+  },
+};

package/src/registry/services/gitea.ts

@@ -0,0 +1,24 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const giteaService: ServiceDefinition = {
+  id: 'gitea',
+  name: 'Gitea',
+  icon: 'GitBranch',
+  color: '#609926',
+  authProvider: 'gitea',
+  grantsUrl: 'https://gitea.io/en-us/user_settings/applications',
+  capabilities: [
+    { id: 'file-system', supported: true },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: true },
+    { id: 'git-host', supported: true },
+    { id: 'media', supported: false },
+    { id: 'contacts', supported: false },
+    { id: 'calendar', supported: false },
+  ],
+  scopes: {
+    'file-system': ['read:repository'],
+    'git-repo': ['read:repository'],
+    'git-host': ['read:repository', 'read:user'],
+  },
+};

package/src/registry/services/github.ts

@@ -0,0 +1,24 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const githubService: ServiceDefinition = {
+  id: 'github',
+  name: 'GitHub',
+  icon: 'Github',
+  color: '#24292F',
+  authProvider: 'github',
+  grantsUrl: 'https://github.com/settings/applications',
+  capabilities: [
+    { id: 'file-system', supported: true },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: true },
+    { id: 'git-host', supported: true },
+    { id: 'media', supported: false },
+    { id: 'contacts', supported: false },
+    { id: 'calendar', supported: false },
+  ],
+  scopes: {
+    'file-system': ['repo'],
+    'git-repo': ['repo'],
+    'git-host': ['repo'],
+  },
+};

package/src/registry/services/gitlab.ts

@@ -0,0 +1,24 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const gitlabService: ServiceDefinition = {
+  id: 'gitlab',
+  name: 'GitLab',
+  icon: 'GitBranch',
+  color: '#FC6D26',
+  authProvider: 'gitlab',
+  grantsUrl: 'https://gitlab.com/-/user_settings/applications',
+  capabilities: [
+    { id: 'file-system', supported: true },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: true },
+    { id: 'git-host', supported: true },
+    { id: 'media', supported: false },
+    { id: 'contacts', supported: false },
+    { id: 'calendar', supported: false },
+  ],
+  scopes: {
+    'file-system': ['read_api'],
+    'git-repo': ['read_api'],
+    'git-host': ['read_api'],
+  },
+};

package/src/registry/services/google.ts

@@ -0,0 +1,24 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const googleService: ServiceDefinition = {
+  id: 'google',
+  name: 'Google',
+  icon: 'Cloud',
+  color: '#4285F4',
+  authProvider: 'google',
+  grantsUrl: 'https://myaccount.google.com/permissions',
+  capabilities: [
+    { id: 'file-system', supported: true },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: false },
+    { id: 'git-host', supported: false },
+    { id: 'media', supported: false },
+    { id: 'contacts', supported: true },
+    { id: 'calendar', supported: true },
+  ],
+  scopes: {
+    'file-system': ['https://www.googleapis.com/auth/drive'],
+    'calendar': ['https://www.googleapis.com/auth/calendar.readonly'],
+    'contacts': ['https://www.googleapis.com/auth/contacts.readonly'],
+  },
+};

package/src/registry/services/icloud.ts

@@ -0,0 +1,23 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const icloudService: ServiceDefinition = {
+  id: 'icloud',
+  name: 'iCloud',
+  icon: 'Cloud',
+  color: '#007AFF',
+  authProvider: 'icloud',
+  grantsUrl: 'https://appleid.apple.com/account/manage',
+  capabilities: [
+    { id: 'file-system', supported: false },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: false },
+    { id: 'git-host', supported: false },
+    { id: 'media', supported: false },
+    { id: 'contacts', supported: true },
+    { id: 'calendar', supported: true },
+  ],
+  scopes: {
+    contacts: [],
+    calendar: [],
+  },
+};

package/src/registry/services/indexeddb.ts

@@ -0,0 +1,19 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const indexeddbService: ServiceDefinition = {
+  id: 'indexeddb',
+  name: 'IndexedDB',
+  icon: 'Database',
+  color: '#FF9800',
+  authProvider: 'indexeddb',
+  capabilities: [
+    { id: 'file-system', supported: true },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: false },
+    { id: 'git-host', supported: false },
+    { id: 'media', supported: false },
+    { id: 'contacts', supported: false },
+    { id: 'calendar', supported: false },
+  ],
+  scopes: {},
+};

package/src/registry/services/instagram.ts

@@ -0,0 +1,22 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const instagramService: ServiceDefinition = {
+  id: 'instagram',
+  name: 'Instagram',
+  icon: 'Camera',
+  color: '#E4405F',
+  authProvider: 'instagram',
+  grantsUrl: 'https://www.instagram.com/accounts/apps/',
+  capabilities: [
+    { id: 'file-system', supported: false },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: false },
+    { id: 'git-host', supported: false },
+    { id: 'media', supported: true },
+    { id: 'contacts', supported: false },
+    { id: 'calendar', supported: false },
+  ],
+  scopes: {
+    'media': ['user_profile', 'user_media'],
+  },
+};

package/src/registry/services/microsoft.ts

@@ -0,0 +1,24 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const microsoftService: ServiceDefinition = {
+  id: 'microsoft',
+  name: 'Microsoft',
+  icon: 'AppWindow',
+  color: '#00A4EF',
+  authProvider: 'microsoft',
+  grantsUrl: 'https://account.live.com/consent/Manage',
+  capabilities: [
+    { id: 'file-system', supported: true },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: false },
+    { id: 'git-host', supported: false },
+    { id: 'media', supported: false },
+    { id: 'contacts', supported: true },
+    { id: 'calendar', supported: true },
+  ],
+  scopes: {
+    'file-system': ['Files.ReadWrite.All'],
+    'contacts': ['Contacts.Read'],
+    'calendar': ['Calendars.Read'],
+  },
+};

package/src/registry/services/s3.ts

@@ -0,0 +1,21 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const s3Service: ServiceDefinition = {
+  id: 's3',
+  name: 'Amazon S3',
+  icon: 'Database',
+  color: '#FF9900',
+  authProvider: 's3',
+  capabilities: [
+    { id: 'file-system', supported: false },
+    { id: 'object-storage', supported: true },
+    { id: 'git-repo', supported: false },
+    { id: 'git-host', supported: false },
+    { id: 'media', supported: false },
+    { id: 'contacts', supported: false },
+    { id: 'calendar', supported: false },
+  ],
+  scopes: {
+    'object-storage': ['s3:GetObject', 's3:PutObject', 's3:ListBucket'],
+  },
+};

package/src/registry/services/webdav.ts

@@ -0,0 +1,21 @@
+import type { ServiceDefinition } from '../../types/service';
+
+export const webdavService: ServiceDefinition = {
+  id: 'webdav',
+  name: 'WebDAV',
+  icon: 'Server',
+  color: '#6B7280',
+  authProvider: 'webdav',
+  capabilities: [
+    { id: 'file-system', supported: true },
+    { id: 'object-storage', supported: false },
+    { id: 'git-repo', supported: false },
+    { id: 'git-host', supported: false },
+    { id: 'media', supported: false },
+    { id: 'contacts', supported: false },
+    { id: 'calendar', supported: false },
+  ],
+  scopes: {
+    'file-system': [],
+  },
+};

package/src/registry.ts

@@ -0,0 +1,4 @@
+// Registry-only entry point — no React, safe for server components
+export type { CapabilityId, ServiceCapability, ServiceDefinition } from './types/service';
+export { serviceRegistry } from './registry/service-registry';
+export { getScopeLabels, getScopeLabel } from './utils/scope-labels';

package/src/types/connection-state.ts

@@ -0,0 +1,33 @@
+import { match } from 'ts-pattern';
+import type { ConnectionManagerModel } from '../models/ConnectionManagerModel';
+import type { IUserProfile } from './user-profile';
+
+export type ServiceConnectionState =
+  | { status: 'loading' }
+  | { status: 'not_configured' }
+  | { status: 'disconnected' }
+  | { status: 'connecting' }
+  | { status: 'connected'; token: string; user: { name: string; image?: string } | null; profile: IUserProfile | undefined }
+  | { status: 'error'; error?: string }
+  | { status: 'expired' };
+
+export function getServiceConnectionState(
+  connectionManager: ConnectionManagerModel,
+  serviceId: string
+): ServiceConnectionState {
+  const status = connectionManager.getStatus(serviceId);
+  return match(status)
+    .with('loading', () => ({ status: 'loading' as const }))
+    .with('not_configured', () => ({ status: 'not_configured' as const }))
+    .with('disconnected', () => ({ status: 'disconnected' as const }))
+    .with('connecting', () => ({ status: 'connecting' as const }))
+    .with('connected', () => ({
+      status: 'connected' as const,
+      token: connectionManager.getToken(serviceId) ?? '',
+      user: connectionManager.getUserInfo(serviceId),
+      profile: connectionManager.getUserProfile(serviceId),
+    }))
+    .with('error', () => ({ status: 'error' as const }))
+    .with('expired', () => ({ status: 'expired' as const }))
+    .exhaustive();
+}

package/src/types/connection.ts

@@ -0,0 +1,11 @@
+export type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'expired' | 'error' | 'not_configured' | 'loading';
+
+export interface ConnectedService {
+  serviceId: string;
+  status: ConnectionStatus;
+  accessToken?: string | undefined;
+  refreshToken?: string | undefined;
+  expiresAt?: number | undefined;
+  scopes: string[];
+  connectedAt?: Date;
+}

package/src/types/optional-deps.d.ts

@@ -0,0 +1,149 @@
+declare module '@anymux/object-ui' {
+  import type { FC } from 'react';
+  import type { IMediaProvider } from '@anymux/object-ui/types/media';
+  import type { IContactProvider } from '@anymux/object-ui/types/contact';
+  import type { ICalendarProvider } from '@anymux/object-ui/types/calendar';
+
+  export const MediaBrowserDemo: FC;
+  export const ContactBrowserDemo: FC;
+  export const CalendarBrowserDemo: FC;
+
+  export class MediaBrowserModel {
+    constructor(provider: IMediaProvider);
+  }
+  export class ContactListModel {
+    constructor(provider: IContactProvider);
+  }
+  export class CalendarModel {
+    constructor(provider: ICalendarProvider);
+  }
+
+  export const MediaBrowser: FC<{ model: MediaBrowserModel; provider: IMediaProvider; className?: string }>;
+  export const ContactBrowser: FC<{ model: ContactListModel; className?: string }>;
+  export const CalendarBrowser: FC<{ model: CalendarModel; className?: string }>;
+}
+
+declare module '@anymux/google-drive' {
+  import type { IFileSystem } from '@anymux/file-system';
+  import type { IMediaProvider } from '@anymux/object-ui/types/media';
+  import type { IContactProvider } from '@anymux/object-ui/types/contact';
+  import type { ICalendarProvider } from '@anymux/object-ui/types/calendar';
+
+  export class GoogleDriveFileSystem implements IFileSystem {
+    constructor(config: { accessToken: string; rootFolderId?: string });
+    readdir(path: string): Promise<string[]>;
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+    mkdir(path: string): Promise<void>;
+    stat(path: string): Promise<unknown>;
+  }
+
+  export class GooglePhotosMediaProvider implements IMediaProvider {
+    constructor(accessToken: string);
+  }
+
+  export class GoogleContactsProvider implements IContactProvider {
+    constructor(accessToken: string);
+  }
+
+  export class GoogleCalendarProvider implements ICalendarProvider {
+    constructor(accessToken: string);
+  }
+}
+
+declare module '@anymux/dropbox' {
+  import type { IFileSystem } from '@anymux/file-system';
+
+  export class DropboxFileSystem implements IFileSystem {
+    constructor(config: { accessToken: string });
+    readdir(path: string): Promise<string[]>;
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+    mkdir(path: string): Promise<void>;
+    stat(path: string): Promise<unknown>;
+  }
+}
+
+declare module '@anymux/github' {
+  import type { IFileSystem, IGitRepo, IGitHost } from '@anymux/file-system';
+
+  export class GitHubFileSystem implements IFileSystem {
+    constructor(config: { token: string; owner: string; repo: string; branch?: string });
+    readdir(path: string): Promise<string[]>;
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+    mkdir(path: string): Promise<void>;
+    stat(path: string): Promise<unknown>;
+  }
+
+  export class GitHubGitRepo implements IGitRepo {
+    constructor(config: { token: string; owner: string; repo: string });
+  }
+
+  export class GitHubGitHost implements IGitHost {
+    constructor(config: { token: string; owner: string; repo: string });
+  }
+}
+
+declare module '@anymux/s3' {
+  import type { IObjectStorage } from '@anymux/file-system';
+
+  export class S3ObjectStorage implements IObjectStorage {
+    constructor(config: {
+      region: string;
+      endpoint?: string;
+      credentials?: { accessKeyId: string; secretAccessKey: string };
+      forcePathStyle?: boolean;
+      bucket?: string;
+    });
+  }
+}
+
+declare module '@anymux/webdav' {
+  import type { IFileSystem } from '@anymux/file-system';
+
+  export class WebDAVFileSystem implements IFileSystem {
+    constructor(config: { url: string; username?: string; password?: string });
+    readdir(path: string): Promise<string[]>;
+    readFile(path: string): Promise<string>;
+    writeFile(path: string, content: string): Promise<void>;
+    mkdir(path: string): Promise<void>;
+    stat(path: string): Promise<unknown>;
+  }
+}
+
+declare module '@anymux/icloud' {
+  import type { ICalendarProvider } from '@anymux/object-ui/types/calendar';
+  import type { IContactProvider } from '@anymux/object-ui/types/contact';
+
+  export interface ICloudCredentials {
+    email: string;
+    appPassword: string;
+    proxyUrl?: string;
+  }
+
+  export class ICloudCalendarProvider implements ICalendarProvider {
+    constructor(credentials: ICloudCredentials);
+  }
+
+  export class ICloudContactsProvider implements IContactProvider {
+    constructor(credentials: ICloudCredentials);
+  }
+}
+
+declare module '@anymux/flickr' {
+  import type { IMediaProvider } from '@anymux/object-ui/types/media';
+
+  export interface FlickrClientConfig {
+    apiKey: string;
+    accessToken?: string;
+  }
+
+  export class FlickrMediaProvider implements IMediaProvider {
+    constructor(config: FlickrClientConfig);
+  }
+
+  export class FlickrClient {
+    constructor(config: FlickrClientConfig);
+  }
+}

package/src/types/service.ts

@@ -0,0 +1,18 @@
+export type CapabilityId = 'file-system' | 'object-storage' | 'git-repo' | 'git-host' | 'media' | 'contacts' | 'calendar';
+
+export interface ServiceCapability {
+  id: CapabilityId;
+  supported: boolean;
+}
+
+export interface ServiceDefinition {
+  id: string;
+  name: string;
+  icon: string;
+  color: string;
+  authProvider: string;
+  capabilities: ServiceCapability[];
+  scopes: Partial<Record<CapabilityId, string[]>>;
+  /** URL to the provider's app permissions/grants page where users can manage access */
+  grantsUrl?: string;
+}

package/src/types/user-profile.ts

@@ -0,0 +1,21 @@
+/**
+ * Normalized user profile from any OAuth provider or credential-based service.
+ * Each connected service produces its own IUserProfile, so a user who connects
+ * both GitHub and Google will have two profiles with different avatars, names, etc.
+ */
+export interface IUserProfile {
+  /** Provider-specific user id (e.g. GitHub numeric id, Google sub) */
+  id: string;
+  /** Display name from the provider */
+  name: string;
+  /** Email associated with this provider account */
+  email?: string;
+  /** Avatar / profile picture URL */
+  avatarUrl?: string;
+  /** Link to the user's profile on the provider (e.g. github.com/user) */
+  profileUrl?: string;
+  /** AnyMux service id (e.g. 'github', 'google-drive') */
+  provider: string;
+  /** Raw provider-specific data for future use */
+  raw?: Record<string, unknown>;
+}

package/src/utils/action-toast.ts

@@ -0,0 +1,53 @@
+import { toast } from 'sonner';
+import type { ActionNotificationModel, ActionType } from '../models/ActionNotificationModel';
+
+/**
+ * Show a toast notification for a user action, with optional undo.
+ * Records the action in the ActionNotificationModel for history.
+ */
+export function showActionToast(
+  model: ActionNotificationModel,
+  type: ActionType,
+  description: string,
+  options?: {
+    undo?: () => Promise<void>;
+    /** Duration in ms before auto-dismiss. Default 5000. */
+    duration?: number;
+  },
+): string {
+  const actionId = model.record(type, description, options?.undo);
+
+  if (options?.undo) {
+    toast(description, {
+      duration: options.duration ?? 5000,
+      action: {
+        label: 'Undo',
+        onClick: async () => {
+          try {
+            await options.undo!();
+            model.markUndone(actionId);
+            toast.success('Action undone');
+          } catch (err) {
+            toast.error(`Undo failed: ${err instanceof Error ? err.message : 'Unknown error'}`);
+          }
+        },
+      },
+    });
+  } else {
+    toast.success(description, {
+      duration: options?.duration ?? 3000,
+    });
+  }
+
+  return actionId;
+}
+
+/** Show an error toast */
+export function showErrorToast(message: string, context?: string) {
+  toast.error(context ? `${context}: ${message}` : message);
+}
+
+/** Show an info toast */
+export function showInfoToast(message: string) {
+  toast.info(message);
+}