@dotdo/do 0.1.0

package/dist/types/identity.d.ts

@@ -0,0 +1,141 @@
+/**
+ * Core Identity Model for Digital Objects
+ *
+ * Every DO has three identity properties: $id, $type, and optional $context
+ * All identifiers are real HTTPS URLs - no custom schemes.
+ *
+ * DUAL NATURE PATTERN (N-Level Hierarchy):
+ * A Thing inside a parent DO can also BE its own independent DO.
+ * This pattern supports unlimited nesting depth.
+ *
+ * Example hierarchy:
+ * ```
+ * https://startups.studio (Business DO)
+ *   └─ headless.ly (Thing in startups.studio)
+ *        └─ https://headless.ly (Startup DO, $context: 'https://startups.studio')
+ *             └─ https://crm.headless.ly (SaaS App DO, $context: 'https://headless.ly')
+ *                  └─ https://crm.headless.ly/acme (Tenant DO, $context: 'https://crm.headless.ly')
+ * ```
+ *
+ * $context chain (all HTTPS URLs):
+ * - https://crm.headless.ly/acme.$context = 'https://crm.headless.ly'
+ * - https://crm.headless.ly.$context = 'https://headless.ly'
+ * - https://headless.ly.$context = 'https://startups.studio'
+ *
+ * Bidirectional relationships:
+ * - Parent → Child: Thing.$ref = 'https://child.domain' (URL string)
+ * - Child → Parent: DO.$context = 'https://parent.domain' (URL string)
+ *
+ * CDC events bubble up: Child DO → Parent DO ($context) → ... → R2/Iceberg
+ * Each level can observe/aggregate events from all descendants.
+ */
+/**
+ * $type is a URL that defines the type/schema of this DO
+ *
+ * Type URL patterns:
+ * - Relative to $context: If $context is 'https://startups.studio' and type is 'Startup',
+ *   the resolved $type URL is 'https://startups.studio/Startup'
+ * - External schema: 'https://schema.org.ai/Agent' - using shared schema definitions
+ * - Platform types: 'https://do.md/Business', 'https://do.md/SaaS'
+ *
+ * Examples:
+ * ```typescript
+ * // Type derived from $context
+ * {
+ *   $id: 'https://headless.ly',
+ *   $type: 'https://startups.studio/Startup',  // or just 'Startup' if $context resolves it
+ *   $context: 'https://startups.studio'
+ * }
+ *
+ * // External schema type
+ * {
+ *   $id: 'https://agents.do/sales-agent',
+ *   $type: 'https://schema.org.ai/Agent',
+ *   $context: 'https://agents.do'
+ * }
+ * ```
+ */
+export type DOType = string;
+/**
+ * Well-known type names (resolve to https://do.md/{TypeName})
+ *
+ * Business Types: Top-level business constructs
+ * Content Types: Sites, apps, and content entities
+ * Operational Types: Runtime components
+ * Utility Types: Supporting entities
+ */
+export type WellKnownType = 'Business' | 'Startup' | 'SaaS' | 'IaaS' | 'PaaS' | 'Service' | 'Site' | 'App' | 'Page' | 'Post' | 'Doc' | 'Agent' | 'Database' | 'Directory' | 'Marketplace' | 'Workflow' | 'Function' | 'Collection' | 'User' | 'Org';
+/**
+ * Resolve a type name to its full URL
+ *
+ * @param typeName - Short name like 'Startup' or full URL
+ * @param context - Optional $context URL to resolve relative types
+ * @returns Full type URL
+ *
+ * Examples:
+ * - resolveTypeUrl('Startup') → 'https://do.md/Startup'
+ * - resolveTypeUrl('Startup', 'https://startups.studio') → 'https://startups.studio/Startup'
+ * - resolveTypeUrl('https://schema.org.ai/Agent') → 'https://schema.org.ai/Agent'
+ */
+export declare function resolveTypeUrl(typeName: string, context?: string): string;
+/**
+ * Reference to another Digital Object - just a URL string
+ * Used for $context, $ref, relationships, and dependencies
+ *
+ * Examples:
+ * - 'https://startups.studio'
+ * - 'https://headless.ly'
+ * - 'https://crm.headless.ly/acme'
+ */
+export type DigitalObjectRef = string;
+/**
+ * Core identity interface for all Digital Objects
+ */
+export interface DigitalObjectIdentity {
+    /** HTTPS URL: https://domain or https://domain/path */
+    $id: string;
+    /**
+     * Type URL - defines the schema/type of this DO
+     *
+     * Can be:
+     * - Full URL: 'https://schema.org.ai/Agent'
+     * - Relative to $context: 'Startup' resolves to '${$context}/Startup'
+     * - Platform type: 'Business' resolves to 'https://do.md/Business'
+     */
+    $type: DOType;
+    /** Parent DO URL for streaming (hierarchical CDC) */
+    $context?: DigitalObjectRef;
+    /** Version number for optimistic concurrency */
+    $version: number;
+    /** Creation timestamp (Unix ms) */
+    $createdAt: number;
+    /** Last update timestamp (Unix ms) */
+    $updatedAt: number;
+}
+/**
+ * Parse a DO URL into its components
+ */
+export interface ParsedDOUrl {
+    /** Always https */
+    protocol: 'https';
+    /** Domain (e.g., 'headless.ly', 'crm.headless.ly') */
+    domain: string;
+    /** Path after domain (e.g., '/acme', '/users/bob') */
+    path?: string;
+}
+/**
+ * DO metadata that can be attached to any object
+ */
+export interface DOMetadata {
+    /** Human-readable name */
+    name?: string;
+    /** Description of this DO */
+    description?: string;
+    /** Tags for categorization */
+    tags?: string[];
+    /** Custom labels (key-value pairs) */
+    labels?: Record<string, string>;
+    /** Annotations (non-identifying metadata) */
+    annotations?: Record<string, unknown>;
+}
+//# sourceMappingURL=identity.d.ts.map

package/dist/types/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../types/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAA;AAE3B;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAErB,UAAU,GACV,SAAS,GACT,MAAM,GACN,MAAM,GACN,MAAM,GACN,SAAS,GAGT,MAAM,GACN,KAAK,GACL,MAAM,GACN,MAAM,GACN,KAAK,GAGL,OAAO,GACP,UAAU,GACV,WAAW,GACX,aAAa,GAGb,UAAU,GACV,UAAU,GACV,YAAY,GACZ,MAAM,GACN,KAAK,CAAA;AAET;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CASzE;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAA;AAErC;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,GAAG,EAAE,MAAM,CAAA;IACX;;;;;;;OAOG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,qDAAqD;IACrD,QAAQ,CAAC,EAAE,gBAAgB,CAAA;IAC3B,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAA;IAClB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mBAAmB;IACnB,QAAQ,EAAE,OAAO,CAAA;IACjB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAA;IACd,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACtC"}

package/dist/types/identity.js

@@ -0,0 +1,54 @@
+/**
+ * Core Identity Model for Digital Objects
+ *
+ * Every DO has three identity properties: $id, $type, and optional $context
+ * All identifiers are real HTTPS URLs - no custom schemes.
+ *
+ * DUAL NATURE PATTERN (N-Level Hierarchy):
+ * A Thing inside a parent DO can also BE its own independent DO.
+ * This pattern supports unlimited nesting depth.
+ *
+ * Example hierarchy:
+ * ```
+ * https://startups.studio (Business DO)
+ *   └─ headless.ly (Thing in startups.studio)
+ *        └─ https://headless.ly (Startup DO, $context: 'https://startups.studio')
+ *             └─ https://crm.headless.ly (SaaS App DO, $context: 'https://headless.ly')
+ *                  └─ https://crm.headless.ly/acme (Tenant DO, $context: 'https://crm.headless.ly')
+ * ```
+ *
+ * $context chain (all HTTPS URLs):
+ * - https://crm.headless.ly/acme.$context = 'https://crm.headless.ly'
+ * - https://crm.headless.ly.$context = 'https://headless.ly'
+ * - https://headless.ly.$context = 'https://startups.studio'
+ *
+ * Bidirectional relationships:
+ * - Parent → Child: Thing.$ref = 'https://child.domain' (URL string)
+ * - Child → Parent: DO.$context = 'https://parent.domain' (URL string)
+ *
+ * CDC events bubble up: Child DO → Parent DO ($context) → ... → R2/Iceberg
+ * Each level can observe/aggregate events from all descendants.
+ */
+/**
+ * Resolve a type name to its full URL
+ *
+ * @param typeName - Short name like 'Startup' or full URL
+ * @param context - Optional $context URL to resolve relative types
+ * @returns Full type URL
+ *
+ * Examples:
+ * - resolveTypeUrl('Startup') → 'https://do.md/Startup'
+ * - resolveTypeUrl('Startup', 'https://startups.studio') → 'https://startups.studio/Startup'
+ * - resolveTypeUrl('https://schema.org.ai/Agent') → 'https://schema.org.ai/Agent'
+ */
+export function resolveTypeUrl(typeName, context) {
+    // Already a URL
+    if (typeName.startsWith('https://'))
+        return typeName;
+    // Resolve relative to context if provided
+    if (context)
+        return `${context}/${typeName}`;
+    // Fall back to platform types
+    return `https://do.md/${typeName}`;
+}
+//# sourceMappingURL=identity.js.map

package/dist/types/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../types/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAmEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAgB;IAC/D,gBAAgB;IAChB,IAAI,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,QAAQ,CAAA;IAEpD,0CAA0C;IAC1C,IAAI,OAAO;QAAE,OAAO,GAAG,OAAO,IAAI,QAAQ,EAAE,CAAA;IAE5C,8BAA8B;IAC9B,OAAO,iBAAiB,QAAQ,EAAE,CAAA;AACpC,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Digital Object (DO) Type Definitions
+ *
+ * This module exports all types for the DO system.
+ *
+ * DO combines:
+ * - DB4.AI (4 database paradigms)
+ * - MDXDB (URL-based content filesystem)
+ * - Fn<Out,In,Opts> (generative functions)
+ * - 11-stage cascade (startup generation)
+ * - mdxui (Site/App components)
+ * - gitx (content/code sync)
+ */
+export * from './identity';
+export * from './collections';
+export * from './databases';
+export * from './execution';
+export * from './storage';
+export * from './colo';
+export * from './rpc';
+export * from './observability';
+export * from './mdxui';
+export { SITE_TYPE_DEFAULTS, siteAutoWiring, } from './site';
+export type { MDXUISiteProps, MDXUIHeaderProps, MDXUIFooterProps, MDXUIHeroProps, MDXUIFeaturesProps, MDXUIPricingProps, MDXUITestimonialsProps, MDXUIFAQProps, MDXUICTASectionProps, MDXUIStatsProps, MDXUITeamSectionProps, MDXUILogosProps, SiteFeatures, SiteTypeName, SiteConfig, SiteTheme, SiteSEO, NavigationConfig, FooterConfig, FooterLinkGroup, SiteComponents, CTAProps, SiteType, } from './site';
+export { APP_TYPE_DEFAULTS } from './app';
+export type { AppFeatures, AppPlatform, AppStatus, AppConfig, AppAuthConfig, AppTheme, ShellConfig, AppComponents, DashboardMetric, DashboardLayout, WidgetType, ChartType, DashboardWidget, APIKeyConfig, WebhookConfig, UsageMetrics, BillingConfig, AppInvoice, AppType, } from './app';
+export * from './content';
+export * from './startup';
+export * from './functions';
+export * from './cascade';
+export * from './git';
+export * from './financial';
+export * from './domains';
+export * from './communication';
+export * from './integrations';
+export * from './telephony';
+export * from './voice-ai';
+export * from './ai';
+export * from './context';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,cAAc,YAAY,CAAA;AAG1B,cAAc,eAAe,CAAA;AAG7B,cAAc,aAAa,CAAA;AAG3B,cAAc,aAAa,CAAA;AAG3B,cAAc,WAAW,CAAA;AAGzB,cAAc,QAAQ,CAAA;AAGtB,cAAc,OAAO,CAAA;AAGrB,cAAc,iBAAiB,CAAA;AAI/B,cAAc,SAAS,CAAA;AAIvB,OAAO,EACL,kBAAkB,EAClB,cAAc,GACf,MAAM,QAAQ,CAAA;AAEf,YAAY,EAEV,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,eAAe,EAEf,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,cAAc,EACd,QAAQ,EACR,QAAQ,GACT,MAAM,QAAQ,CAAA;AAIf,OAAO,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAEzC,YAAY,EAEV,WAAW,EACX,WAAW,EACX,SAAS,EACT,SAAS,EACT,aAAa,EACb,QAAQ,EACR,WAAW,EACX,aAAa,EACb,eAAe,EACf,eAAe,EACf,UAAU,EACV,SAAS,EACT,eAAe,EACf,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,OAAO,GACR,MAAM,OAAO,CAAA;AAGd,cAAc,WAAW,CAAA;AAGzB,cAAc,WAAW,CAAA;AAGzB,cAAc,aAAa,CAAA;AAG3B,cAAc,WAAW,CAAA;AAGzB,cAAc,OAAO,CAAA;AAGrB,cAAc,aAAa,CAAA;AAG3B,cAAc,WAAW,CAAA;AAGzB,cAAc,iBAAiB,CAAA;AAG/B,cAAc,gBAAgB,CAAA;AAG9B,cAAc,aAAa,CAAA;AAG3B,cAAc,YAAY,CAAA;AAG1B,cAAc,MAAM,CAAA;AAGpB,cAAc,WAAW,CAAA"}

package/dist/types/index.js

@@ -0,0 +1,65 @@
+/**
+ * Digital Object (DO) Type Definitions
+ *
+ * This module exports all types for the DO system.
+ *
+ * DO combines:
+ * - DB4.AI (4 database paradigms)
+ * - MDXDB (URL-based content filesystem)
+ * - Fn<Out,In,Opts> (generative functions)
+ * - 11-stage cascade (startup generation)
+ * - mdxui (Site/App components)
+ * - gitx (content/code sync)
+ */
+// Core identity model ($id, $type, $context, DOType)
+export * from './identity';
+// Collections (nouns, verbs, things, actions, etc.)
+export * from './collections';
+// Database backends (DB4.AI - 4 paradigms)
+export * from './databases';
+// Code execution (fsx, gitx, bashx, esm)
+export * from './execution';
+// Storage & CDC (tiered storage, change data capture)
+export * from './storage';
+// Colo awareness (geo-distribution, replication)
+export * from './colo';
+// CapnWeb RPC (schema-free RPC with hibernation)
+export * from './rpc';
+// Observability (events, metrics, tracing)
+export * from './observability';
+// MDXUI types - Zod schemas and component props
+// DO entities ARE the props for MDXUI components
+export * from './mdxui';
+// Site types (mdxui - 14 site types, SiteComponents)
+// Note: Exclude types that conflict with ./mdxui exports
+export { SITE_TYPE_DEFAULTS, siteAutoWiring, } from './site';
+// App types (mdxui - 18 app types, AppComponents)
+// Note: Exclude types that conflict with ./mdxui exports
+export { APP_TYPE_DEFAULTS } from './app';
+// Content types (mdxld/mdxdb - URL-based filesystem)
+export * from './content';
+// Startup types (sb - ICP, Persona, Hypothesis, Canvas, etc.)
+export * from './startup';
+// Function types (Fn<Out,In,Opts> pattern)
+export * from './functions';
+// Cascade types (11-stage generative workflow)
+export * from './cascade';
+// Git types (content/code sync with git)
+export * from './git';
+// Financial types (Stripe Connect, accounting, P&L)
+export * from './financial';
+// Domain types (subdomains, DNS, SSL, routing)
+export * from './domains';
+// Communication types (email, Slack, Discord, Teams)
+export * from './communication';
+// Integration types (deep vs generic integrations)
+export * from './integrations';
+// Telephony types (phone, SMS, calls)
+export * from './telephony';
+// Voice AI types (conversational voice agents)
+export * from './voice-ai';
+// AI types (unified generative AI abstraction)
+export * from './ai';
+// Context types ($ - the runtime context)
+export * from './context';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,qDAAqD;AACrD,cAAc,YAAY,CAAA;AAE1B,oDAAoD;AACpD,cAAc,eAAe,CAAA;AAE7B,2CAA2C;AAC3C,cAAc,aAAa,CAAA;AAE3B,yCAAyC;AACzC,cAAc,aAAa,CAAA;AAE3B,sDAAsD;AACtD,cAAc,WAAW,CAAA;AAEzB,iDAAiD;AACjD,cAAc,QAAQ,CAAA;AAEtB,iDAAiD;AACjD,cAAc,OAAO,CAAA;AAErB,2CAA2C;AAC3C,cAAc,iBAAiB,CAAA;AAE/B,gDAAgD;AAChD,iDAAiD;AACjD,cAAc,SAAS,CAAA;AAEvB,qDAAqD;AACrD,yDAAyD;AACzD,OAAO,EACL,kBAAkB,EAClB,cAAc,GACf,MAAM,QAAQ,CAAA;AA8Bf,kDAAkD;AAClD,yDAAyD;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAA;AAyBzC,qDAAqD;AACrD,cAAc,WAAW,CAAA;AAEzB,8DAA8D;AAC9D,cAAc,WAAW,CAAA;AAEzB,2CAA2C;AAC3C,cAAc,aAAa,CAAA;AAE3B,+CAA+C;AAC/C,cAAc,WAAW,CAAA;AAEzB,yCAAyC;AACzC,cAAc,OAAO,CAAA;AAErB,oDAAoD;AACpD,cAAc,aAAa,CAAA;AAE3B,+CAA+C;AAC/C,cAAc,WAAW,CAAA;AAEzB,qDAAqD;AACrD,cAAc,iBAAiB,CAAA;AAE/B,mDAAmD;AACnD,cAAc,gBAAgB,CAAA;AAE9B,sCAAsC;AACtC,cAAc,aAAa,CAAA;AAE3B,+CAA+C;AAC/C,cAAc,YAAY,CAAA;AAE1B,+CAA+C;AAC/C,cAAc,MAAM,CAAA;AAEpB,0CAA0C;AAC1C,cAAc,WAAW,CAAA"}

package/dist/types/integrations.d.ts

@@ -0,0 +1,356 @@
+/**
+ * Integration Types - Deep vs Generic Integrations
+ *
+ * DO has two tiers of integrations:
+ *
+ * DEEP INTEGRATIONS (Platform-level, tightly coupled):
+ * - Stripe Connect - Payments, transfers, accounting, financial reporting
+ * - WorkOS - Authentication, SSO, directory sync, RBAC/FGA
+ * - GitHub - Git sync, code storage, PRs, issues, actions
+ * - Cloudflare - Domains, DNS, SSL, email routing, workers
+ * - Communication - Slack, Discord, Teams (human-in-the-loop)
+ *
+ * GENERIC INTEGRATIONS (Webhook/API-level, loosely coupled):
+ * - OAuth connections to any service
+ * - Webhook subscriptions
+ * - API credentials
+ */
+/**
+ * Deep integration types (platform-level)
+ */
+export type DeepIntegrationType = 'stripe' | 'workos' | 'github' | 'cloudflare' | 'slack' | 'discord' | 'teams' | 'ses' | 'mailchannels';
+/**
+ * Deep integration status
+ */
+export type DeepIntegrationStatus = 'NotConfigured' | 'PendingAuth' | 'Active' | 'Error' | 'Suspended';
+/**
+ * Deep integration base interface
+ */
+export interface DeepIntegration {
+    type: DeepIntegrationType;
+    status: DeepIntegrationStatus;
+    connectedAt?: number;
+    lastActivityAt?: number;
+    error?: string;
+}
+export interface StripeDeepIntegration extends DeepIntegration {
+    type: 'stripe';
+    /** Stripe Connect account ID */
+    accountId?: string;
+    /** Account type */
+    accountType?: 'standard' | 'express' | 'custom';
+    /** Charges enabled */
+    chargesEnabled?: boolean;
+    /** Payouts enabled */
+    payoutsEnabled?: boolean;
+    /** Onboarding URL (for incomplete accounts) */
+    onboardingUrl?: string;
+    /** Platform fee percentage */
+    platformFeePercent?: number;
+}
+export interface WorkOSDeepIntegration extends DeepIntegration {
+    type: 'workos';
+    /** Organization ID in WorkOS */
+    organizationId?: string;
+    /** SSO connection ID */
+    ssoConnectionId?: string;
+    /** Directory sync connection ID */
+    directoryConnectionId?: string;
+    /** Enabled features */
+    features?: {
+        sso?: boolean;
+        directorySync?: boolean;
+        adminPortal?: boolean;
+        auditLogs?: boolean;
+    };
+    /** SSO providers configured */
+    ssoProviders?: ('google' | 'microsoft' | 'okta' | 'onelogin' | 'azure' | 'adfs' | 'ping' | 'jumpcloud' | 'saml')[];
+}
+export interface GitHubDeepIntegration extends DeepIntegration {
+    type: 'github';
+    /** GitHub App installation ID */
+    installationId?: string;
+    /** Repository (owner/repo) */
+    repository?: string;
+    /** Branch */
+    branch?: string;
+    /** Base path in repo */
+    basePath?: string;
+    /** Permissions granted */
+    permissions?: {
+        contents?: 'read' | 'write';
+        pullRequests?: 'read' | 'write';
+        issues?: 'read' | 'write';
+        actions?: 'read' | 'write';
+        webhooks?: 'read' | 'write';
+    };
+    /** Webhook secret */
+    webhookSecret?: string;
+    /** Last sync commit SHA */
+    lastSyncSha?: string;
+}
+export interface CloudflareDeepIntegration extends DeepIntegration {
+    type: 'cloudflare';
+    /** Account ID */
+    accountId?: string;
+    /** Zone IDs managed */
+    zoneIds?: string[];
+    /** Workers namespace */
+    workersNamespace?: string;
+    /** KV namespaces */
+    kvNamespaces?: string[];
+    /** R2 buckets */
+    r2Buckets?: string[];
+    /** D1 databases */
+    d1Databases?: string[];
+    /** Durable Object namespaces */
+    durableObjectNamespaces?: string[];
+}
+export interface SlackDeepIntegration extends DeepIntegration {
+    type: 'slack';
+    /** Workspace ID */
+    teamId?: string;
+    /** Workspace name */
+    teamName?: string;
+    /** Bot user ID */
+    botUserId?: string;
+    /** Scopes */
+    scopes?: string[];
+    /** Default channel for notifications */
+    defaultChannelId?: string;
+}
+export interface DiscordDeepIntegration extends DeepIntegration {
+    type: 'discord';
+    /** Guild ID */
+    guildId?: string;
+    /** Guild name */
+    guildName?: string;
+    /** Bot user ID */
+    botUserId?: string;
+    /** Permissions */
+    permissions?: string;
+    /** Default channel for notifications */
+    defaultChannelId?: string;
+}
+export interface TeamsDeepIntegration extends DeepIntegration {
+    type: 'teams';
+    /** Tenant ID */
+    tenantId?: string;
+    /** Team ID */
+    teamId?: string;
+    /** Team name */
+    teamName?: string;
+    /** Default channel for notifications */
+    defaultChannelId?: string;
+}
+export interface SESDeepIntegration extends DeepIntegration {
+    type: 'ses';
+    /** AWS Region */
+    region?: string;
+    /** Verified identities (domains/emails) */
+    verifiedIdentities?: string[];
+    /** Configuration set */
+    configurationSet?: string;
+    /** Sending quota */
+    sendingQuota?: {
+        max24HourSend: number;
+        maxSendRate: number;
+        sentLast24Hours: number;
+    };
+}
+export interface MailchannelsDeepIntegration extends DeepIntegration {
+    type: 'mailchannels';
+    /** Verified domains */
+    verifiedDomains?: string[];
+    /** DKIM configured */
+    dkimConfigured?: boolean;
+}
+/**
+ * Generic integration (loosely coupled)
+ */
+export interface GenericIntegration {
+    id: string;
+    /** Integration name */
+    name: string;
+    /** Provider/service name */
+    provider: string;
+    /** Integration type */
+    type: GenericIntegrationType;
+    /** Configuration */
+    config: Record<string, unknown>;
+    /** Status */
+    status: 'Active' | 'Inactive' | 'Error';
+    /** Credentials reference */
+    credentialId?: string;
+    /** Last used timestamp */
+    lastUsedAt?: number;
+    /** Created timestamp */
+    createdAt: number;
+    /** Updated timestamp */
+    updatedAt: number;
+}
+export type GenericIntegrationType = 'oauth2' | 'api_key' | 'webhook' | 'outbound' | 'database' | 'storage';
+/**
+ * OAuth 2.0 connection
+ */
+export interface OAuthConnection {
+    id: string;
+    /** Provider name */
+    provider: string;
+    /** OAuth client ID */
+    clientId: string;
+    /** Scopes granted */
+    scopes: string[];
+    /** Access token (encrypted) */
+    accessToken: string;
+    /** Refresh token (encrypted) */
+    refreshToken?: string;
+    /** Token expiry timestamp */
+    expiresAt?: number;
+    /** User info from provider */
+    userInfo?: {
+        id: string;
+        email?: string;
+        name?: string;
+        avatar?: string;
+    };
+    /** Connected timestamp */
+    connectedAt: number;
+    /** Last refreshed timestamp */
+    lastRefreshedAt?: number;
+}
+/**
+ * Inbound webhook
+ */
+export interface InboundWebhook {
+    id: string;
+    /** Webhook name */
+    name: string;
+    /** Webhook path */
+    path: string;
+    /** Expected source */
+    source?: string;
+    /** Verification method */
+    verification?: WebhookVerification;
+    /** Handler function ID */
+    handlerId?: string;
+    /** Enabled */
+    enabled: boolean;
+    /** Last received timestamp */
+    lastReceivedAt?: number;
+    /** Total requests received */
+    totalRequests: number;
+    /** Created timestamp */
+    createdAt: number;
+}
+export interface WebhookVerification {
+    method: 'hmac' | 'signature' | 'bearer' | 'basic' | 'none';
+    secret?: string;
+    header?: string;
+    algorithm?: 'sha256' | 'sha512';
+}
+/**
+ * Outbound webhook
+ */
+export interface OutboundWebhook {
+    id: string;
+    /** Webhook name */
+    name: string;
+    /** Destination URL */
+    url: string;
+    /** Events to trigger on */
+    events: string[];
+    /** HTTP method */
+    method: 'POST' | 'PUT' | 'PATCH';
+    /** Custom headers */
+    headers?: Record<string, string>;
+    /** Signing secret */
+    signingSecret?: string;
+    /** Retry policy */
+    retryPolicy?: WebhookRetryPolicy;
+    /** Enabled */
+    enabled: boolean;
+    /** Last triggered timestamp */
+    lastTriggeredAt?: number;
+    /** Failure count */
+    failureCount: number;
+    /** Created timestamp */
+    createdAt: number;
+}
+export interface WebhookRetryPolicy {
+    maxAttempts: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    backoffMultiplier: number;
+}
+/**
+ * Integration operations for a DO
+ */
+export interface IntegrationOperations {
+    getDeepIntegration<T extends DeepIntegration>(type: DeepIntegrationType): Promise<T | null>;
+    configureDeepIntegration<T extends DeepIntegration>(config: Partial<T>): Promise<T>;
+    disconnectDeepIntegration(type: DeepIntegrationType): Promise<boolean>;
+    addIntegration(integration: Omit<GenericIntegration, 'id' | 'createdAt' | 'updatedAt'>): Promise<GenericIntegration>;
+    updateIntegration(id: string, updates: Partial<GenericIntegration>): Promise<GenericIntegration>;
+    removeIntegration(id: string): Promise<boolean>;
+    listIntegrations(type?: GenericIntegrationType): Promise<GenericIntegration[]>;
+    connectOAuth(provider: string, authCode: string): Promise<OAuthConnection>;
+    refreshOAuth(connectionId: string): Promise<OAuthConnection>;
+    disconnectOAuth(connectionId: string): Promise<boolean>;
+    listOAuthConnections(): Promise<OAuthConnection[]>;
+    createInboundWebhook(webhook: Omit<InboundWebhook, 'id' | 'createdAt' | 'totalRequests'>): Promise<InboundWebhook>;
+    createOutboundWebhook(webhook: Omit<OutboundWebhook, 'id' | 'createdAt' | 'failureCount'>): Promise<OutboundWebhook>;
+    triggerOutboundWebhook(webhookId: string, payload: unknown): Promise<{
+        success: boolean;
+        statusCode?: number;
+    }>;
+    listWebhooks(): Promise<{
+        inbound: InboundWebhook[];
+        outbound: OutboundWebhook[];
+    }>;
+}
+/**
+ * Integration event (for observability)
+ */
+export type IntegrationEvent = {
+    type: 'integration:connected';
+    payload: {
+        integrationType: string;
+    };
+} | {
+    type: 'integration:disconnected';
+    payload: {
+        integrationType: string;
+    };
+} | {
+    type: 'integration:error';
+    payload: {
+        integrationType: string;
+        error: string;
+    };
+} | {
+    type: 'webhook:received';
+    payload: {
+        webhookId: string;
+        source?: string;
+    };
+} | {
+    type: 'webhook:sent';
+    payload: {
+        webhookId: string;
+        success: boolean;
+    };
+} | {
+    type: 'oauth:refreshed';
+    payload: {
+        provider: string;
+        connectionId: string;
+    };
+} | {
+    type: 'oauth:expired';
+    payload: {
+        provider: string;
+        connectionId: string;
+    };
+};
+//# sourceMappingURL=integrations.d.ts.map