@objectstack/spec 0.8.1 → 0.9.0

package/dist/hub/hub-federation.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-federation.zod.d.ts","sourceRoot":"","sources":["../../src/hub/hub-federation.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;GAgBG;AAMH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0DvB,CAAC;AAEH,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoE5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAM5D;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoFnC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAM1E;;;GAGG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsEtC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAMhF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqE/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;iBA0BpC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAM5E;;;GAGG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwC7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAM9D,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAQxB,CAAC"}

package/dist/hub/hub-federation.zod.js

@@ -0,0 +1,441 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HubFederationProtocol = exports.EdgeLocationSchema = exports.GlobalRegistryEntrySchema = exports.ReplicationJobSchema = exports.TenantPlacementPolicySchema = exports.FederationTopologySchema = exports.HubInstanceSchema = exports.RegionSchema = void 0;
+const zod_1 = require("zod");
+/**
+ * # Hub Federation Protocol
+ *
+ * Enables distributed ObjectStack Hub deployments across multiple regions,
+ * data centers, or cloud providers. Supports:
+ * - Multi-region plugin distribution
+ * - Federated identity and tenant management
+ * - Cross-region data replication
+ * - Global load balancing
+ * - Disaster recovery
+ *
+ * Use cases:
+ * - Global SaaS deployments with regional data residency
+ * - Multi-cloud resilience
+ * - Edge computing with central management
+ * - Hybrid cloud deployments
+ */
+// ============================================================================
+// Region & Deployment Topology
+// ============================================================================
+/**
+ * Geographic Region
+ */
+exports.RegionSchema = zod_1.z.object({
+    /**
+     * Region identifier (e.g., us-east-1, eu-west-1, ap-southeast-1)
+     */
+    id: zod_1.z.string().regex(/^[a-z]{2}-[a-z]+-\d+$/).describe('Region identifier'),
+    /**
+     * Display name
+     */
+    name: zod_1.z.string().describe('Human-readable region name'),
+    /**
+     * Geographic location
+     */
+    location: zod_1.z.object({
+        continent: zod_1.z.enum(['NA', 'SA', 'EU', 'AF', 'AS', 'OC', 'AN']),
+        country: zod_1.z.string().regex(/^[A-Z]{2}$/).describe('ISO 3166-1 alpha-2 country code'),
+        city: zod_1.z.string().optional(),
+        latitude: zod_1.z.number().min(-90).max(90).optional(),
+        longitude: zod_1.z.number().min(-180).max(180).optional(),
+    }),
+    /**
+     * Cloud provider and region mapping
+     */
+    provider: zod_1.z.object({
+        name: zod_1.z.enum(['aws', 'azure', 'gcp', 'cloudflare', 'vercel', 'self-hosted']),
+        region: zod_1.z.string().describe('Provider-specific region identifier'),
+    }).optional(),
+    /**
+     * Region capabilities
+     */
+    capabilities: zod_1.z.object({
+        databases: zod_1.z.array(zod_1.z.enum(['postgres', 'mysql', 'mongodb', 'redis'])).default([]),
+        storage: zod_1.z.array(zod_1.z.enum(['s3', 'azure-blob', 'gcs'])).default([]),
+        compute: zod_1.z.array(zod_1.z.enum(['containers', 'serverless', 'vm'])).default([]),
+        cdn: zod_1.z.boolean().default(false),
+    }).optional(),
+    /**
+     * Compliance and certifications
+     */
+    compliance: zod_1.z.array(zod_1.z.enum(['gdpr', 'hipaa', 'soc2', 'iso27001', 'pci-dss'])).default([]),
+    /**
+     * Region status
+     */
+    status: zod_1.z.enum(['active', 'read-only', 'maintenance', 'deprecated']).default('active'),
+    /**
+     * Resource limits for this region
+     */
+    limits: zod_1.z.object({
+        maxSpaces: zod_1.z.number().int().positive().optional(),
+        maxTenants: zod_1.z.number().int().positive().optional(),
+        maxStorage: zod_1.z.number().int().positive().optional().describe('Bytes'),
+    }).optional(),
+});
+/**
+ * Hub Instance
+ * Represents a single Hub deployment in a region
+ */
+exports.HubInstanceSchema = zod_1.z.object({
+    /**
+     * Instance identifier
+     */
+    id: zod_1.z.string().uuid(),
+    /**
+     * Region where this hub is deployed
+     */
+    regionId: zod_1.z.string(),
+    /**
+     * Hub role in federation
+     */
+    role: zod_1.z.enum([
+        'primary', // Primary/master hub
+        'secondary', // Read-replica hub
+        'edge', // Edge location for caching
+    ]),
+    /**
+     * Endpoint URLs
+     */
+    endpoints: zod_1.z.object({
+        api: zod_1.z.string().url().describe('Public API endpoint'),
+        admin: zod_1.z.string().url().optional().describe('Admin console'),
+        grpc: zod_1.z.string().optional().describe('gRPC endpoint for inter-hub communication'),
+    }),
+    /**
+     * Replication configuration
+     */
+    replication: zod_1.z.object({
+        /**
+         * Source hub for replication (if this is a secondary)
+         */
+        primaryHubId: zod_1.z.string().uuid().optional(),
+        /**
+         * Replication lag tolerance in seconds
+         */
+        lagTolerance: zod_1.z.number().int().positive().default(5),
+        /**
+         * Replication mode
+         */
+        mode: zod_1.z.enum(['sync', 'async', 'semi-sync']).default('async'),
+    }).optional(),
+    /**
+     * Health status
+     */
+    health: zod_1.z.object({
+        status: zod_1.z.enum(['healthy', 'degraded', 'unhealthy']),
+        lastCheck: zod_1.z.string().datetime(),
+        uptime: zod_1.z.number().describe('Seconds'),
+    }).optional(),
+    /**
+     * Version
+     */
+    version: zod_1.z.string(),
+    /**
+     * Metadata
+     */
+    createdAt: zod_1.z.string().datetime(),
+    updatedAt: zod_1.z.string().datetime(),
+});
+// ============================================================================
+// Federation Topology
+// ============================================================================
+/**
+ * Federation Topology
+ * Defines the global hub network architecture
+ */
+exports.FederationTopologySchema = zod_1.z.object({
+    /**
+     * Federation identifier
+     */
+    id: zod_1.z.string().uuid(),
+    /**
+     * Federation name
+     */
+    name: zod_1.z.string(),
+    /**
+     * Regions in this federation
+     */
+    regions: zod_1.z.array(exports.RegionSchema),
+    /**
+     * Hub instances
+     */
+    hubs: zod_1.z.array(exports.HubInstanceSchema),
+    /**
+     * Routing strategy
+     */
+    routing: zod_1.z.object({
+        /**
+         * How to route tenant requests
+         */
+        strategy: zod_1.z.enum([
+            'geo-proximity', // Route to nearest region
+            'data-residency', // Route based on tenant data location
+            'least-loaded', // Route to least busy hub
+            'custom', // Custom routing logic
+        ]).default('geo-proximity'),
+        /**
+         * Failover behavior
+         */
+        failover: zod_1.z.object({
+            enabled: zod_1.z.boolean().default(true),
+            maxRetries: zod_1.z.number().int().min(0).default(3),
+            timeout: zod_1.z.number().int().positive().default(5000).describe('Milliseconds'),
+        }),
+    }),
+    /**
+     * Data synchronization settings
+     */
+    synchronization: zod_1.z.object({
+        /**
+         * What data to sync across regions
+         */
+        scope: zod_1.z.object({
+            /**
+             * Sync plugin registry
+             */
+            plugins: zod_1.z.boolean().default(true),
+            /**
+             * Sync tenant metadata (not data)
+             */
+            tenants: zod_1.z.boolean().default(true),
+            /**
+             * Sync spaces metadata
+             */
+            spaces: zod_1.z.boolean().default(false),
+            /**
+             * Sync licenses
+             */
+            licenses: zod_1.z.boolean().default(true),
+        }),
+        /**
+         * Sync frequency
+         */
+        frequency: zod_1.z.enum(['realtime', 'hourly', 'daily']).default('realtime'),
+        /**
+         * Conflict resolution
+         */
+        conflictResolution: zod_1.z.enum(['last-write-wins', 'primary-wins', 'manual']).default('last-write-wins'),
+    }),
+});
+// ============================================================================
+// Tenant Placement
+// ============================================================================
+/**
+ * Tenant Placement Policy
+ * Determines where a tenant's data and runtime reside
+ */
+exports.TenantPlacementPolicySchema = zod_1.z.object({
+    /**
+     * Tenant identifier
+     */
+    tenantId: zod_1.z.string(),
+    /**
+     * Primary region (where tenant data lives)
+     */
+    primaryRegion: zod_1.z.string(),
+    /**
+     * Replica regions (for disaster recovery)
+     */
+    replicaRegions: zod_1.z.array(zod_1.z.string()).default([]),
+    /**
+     * Data residency constraints
+     */
+    dataResidency: zod_1.z.object({
+        /**
+         * Allowed regions for data storage
+         */
+        allowedRegions: zod_1.z.array(zod_1.z.string()).optional(),
+        /**
+         * Prohibited regions
+         */
+        prohibitedRegions: zod_1.z.array(zod_1.z.string()).default([]),
+        /**
+         * Continent restriction
+         */
+        continent: zod_1.z.enum(['NA', 'SA', 'EU', 'AF', 'AS', 'OC', 'AN']).optional(),
+    }).optional(),
+    /**
+     * Failover policy
+     */
+    failover: zod_1.z.object({
+        /**
+         * Enable automatic failover
+         */
+        enabled: zod_1.z.boolean().default(true),
+        /**
+         * Preferred failover order (region IDs)
+         */
+        preferredOrder: zod_1.z.array(zod_1.z.string()).default([]),
+        /**
+         * Maximum acceptable latency for failover target (ms)
+         */
+        maxLatency: zod_1.z.number().int().positive().default(100),
+    }).optional(),
+    /**
+     * Latency requirements
+     */
+    latency: zod_1.z.object({
+        /**
+         * Maximum acceptable latency for primary region (ms)
+         */
+        maxPrimaryLatency: zod_1.z.number().int().positive().default(50),
+        /**
+         * Maximum acceptable latency for replicas (ms)
+         */
+        maxReplicaLatency: zod_1.z.number().int().positive().default(200),
+    }).optional(),
+});
+// ============================================================================
+// Cross-Region Operations
+// ============================================================================
+/**
+ * Cross-Region Replication Job
+ */
+exports.ReplicationJobSchema = zod_1.z.object({
+    /**
+     * Job identifier
+     */
+    id: zod_1.z.string().uuid(),
+    /**
+     * Job type
+     */
+    type: zod_1.z.enum([
+        'initial-sync', // First-time full sync
+        'incremental', // Delta sync
+        'conflict-resolution', // Resolve conflicts
+    ]),
+    /**
+     * Source hub
+     */
+    sourceHubId: zod_1.z.string().uuid(),
+    /**
+     * Target hub(s)
+     */
+    targetHubIds: zod_1.z.array(zod_1.z.string().uuid()),
+    /**
+     * Resource scope
+     */
+    scope: zod_1.z.object({
+        /**
+         * Resource type
+         */
+        resourceType: zod_1.z.enum(['plugin', 'tenant', 'space', 'license', 'all']),
+        /**
+         * Specific resource IDs (empty = all)
+         */
+        resourceIds: zod_1.z.array(zod_1.z.string()).default([]),
+    }),
+    /**
+     * Job status
+     */
+    status: zod_1.z.enum(['pending', 'running', 'completed', 'failed', 'cancelled']),
+    /**
+     * Progress
+     */
+    progress: zod_1.z.object({
+        total: zod_1.z.number().int().min(0),
+        completed: zod_1.z.number().int().min(0),
+        failed: zod_1.z.number().int().min(0),
+    }).optional(),
+    /**
+     * Timestamps
+     */
+    createdAt: zod_1.z.string().datetime(),
+    startedAt: zod_1.z.string().datetime().optional(),
+    completedAt: zod_1.z.string().datetime().optional(),
+    /**
+     * Errors
+     */
+    errors: zod_1.z.array(zod_1.z.object({
+        timestamp: zod_1.z.string().datetime(),
+        resourceId: zod_1.z.string(),
+        error: zod_1.z.string(),
+    })).default([]),
+});
+/**
+ * Global Registry Entry
+ * Tracks where a resource exists across regions
+ */
+exports.GlobalRegistryEntrySchema = zod_1.z.object({
+    /**
+     * Resource identifier
+     */
+    resourceId: zod_1.z.string(),
+    /**
+     * Resource type
+     */
+    resourceType: zod_1.z.enum(['plugin', 'tenant', 'space', 'license']),
+    /**
+     * Regions where this resource exists
+     */
+    locations: zod_1.z.array(zod_1.z.object({
+        regionId: zod_1.z.string(),
+        hubId: zod_1.z.string().uuid(),
+        isPrimary: zod_1.z.boolean().default(false),
+        lastSyncedAt: zod_1.z.string().datetime().optional(),
+        version: zod_1.z.string().optional(),
+    })),
+    /**
+     * Global version vector clock (for conflict detection)
+     */
+    versionVector: zod_1.z.record(zod_1.z.string(), zod_1.z.number().int()).optional(),
+});
+// ============================================================================
+// Edge Computing
+// ============================================================================
+/**
+ * Edge Location
+ * Represents a CDN/edge cache location
+ */
+exports.EdgeLocationSchema = zod_1.z.object({
+    /**
+     * Location identifier
+     */
+    id: zod_1.z.string(),
+    /**
+     * Parent region
+     */
+    regionId: zod_1.z.string(),
+    /**
+     * Location details
+     */
+    location: exports.RegionSchema.shape.location,
+    /**
+     * Caching configuration
+     */
+    cache: zod_1.z.object({
+        /**
+         * What to cache at edge
+         */
+        resources: zod_1.z.array(zod_1.z.enum(['plugins', 'static-assets', 'api-responses'])).default([]),
+        /**
+         * TTL in seconds
+         */
+        ttl: zod_1.z.number().int().positive().default(3600),
+        /**
+         * Cache size limit (bytes)
+         */
+        maxSize: zod_1.z.number().int().positive().optional(),
+    }),
+    /**
+     * Status
+     */
+    status: zod_1.z.enum(['active', 'inactive']).default('active'),
+});
+// ============================================================================
+// Export All
+// ============================================================================
+exports.HubFederationProtocol = {
+    Region: exports.RegionSchema,
+    HubInstance: exports.HubInstanceSchema,
+    FederationTopology: exports.FederationTopologySchema,
+    TenantPlacementPolicy: exports.TenantPlacementPolicySchema,
+    ReplicationJob: exports.ReplicationJobSchema,
+    GlobalRegistryEntry: exports.GlobalRegistryEntrySchema,
+    EdgeLocation: exports.EdgeLocationSchema,
+};

package/dist/hub/index.d.ts

@@ -4,4 +4,6 @@ export * from './plugin-registry.zod';
 export * from './space.zod';
 export * from './tenant.zod';
 export * from './license.zod';
+export * from './hub-federation.zod';
+export * from './plugin-security.zod';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hub/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hub/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAG9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/dist/hub/index.js

@@ -21,3 +21,6 @@ __exportStar(require("./plugin-registry.zod"), exports);
 __exportStar(require("./space.zod"), exports);
 __exportStar(require("./tenant.zod"), exports);
 __exportStar(require("./license.zod"), exports);
+// Export Enhanced Hub Protocols
+__exportStar(require("./hub-federation.zod"), exports);
+__exportStar(require("./plugin-security.zod"), exports);