@plures/praxis 1.0.2 → 1.1.0

package/src/cloud/provisioning.ts

@@ -1,11 +1,11 @@
 /**
  * Auto-Provisioning
- * 
+ *
  * Automatic tenant/storage provisioning based on GitHub identity.
  */
 
-import type { GitHubUser } from "./types.js";
-import type { Subscription } from "./billing.js";
+import type { GitHubUser } from './types.js';
+import type { Subscription } from './billing.js';
 
 /**
  * Tenant information
@@ -15,37 +15,37 @@ export interface Tenant {
    * Tenant ID (derived from GitHub user/org)
    */
   id: string;
-  
+
   /**
    * GitHub user ID
    */
   githubUserId: number;
-  
+
   /**
    * GitHub login (username or org name)
    */
   githubLogin: string;
-  
+
   /**
    * Tenant type
    */
-  type: "user" | "organization";
-  
+  type: 'user' | 'organization';
+
   /**
    * Subscription
    */
   subscription: Subscription;
-  
+
   /**
    * Storage namespace
    */
   storageNamespace: string;
-  
+
   /**
    * Creation timestamp
    */
   createdAt: number;
-  
+
   /**
    * Last accessed timestamp
    */
@@ -54,17 +54,17 @@ export interface Tenant {
 
 /**
  * Generate a storage namespace from GitHub login
- * 
+ *
  * Namespace format: gh-{login}-{hash}
  * This ensures uniqueness and follows Azure Blob Storage naming rules.
  */
 export function generateStorageNamespace(githubLogin: string, userId: number): string {
   // Sanitize login: lowercase, replace non-alphanumeric with hyphens
-  const sanitized = githubLogin.toLowerCase().replace(/[^a-z0-9]/g, "-");
-  
+  const sanitized = githubLogin.toLowerCase().replace(/[^a-z0-9]/g, '-');
+
   // Create a simple hash from user ID for uniqueness
-  const hash = userId.toString(36).padStart(6, "0");
-  
+  const hash = userId.toString(36).padStart(6, '0');
+
   // Combine with prefix
   return `gh-${sanitized}-${hash}`;
 }
@@ -79,21 +79,15 @@ export function generateTenantId(githubUser: GitHubUser): string {
 /**
  * Create a tenant from GitHub user
  */
-export function createTenant(
-  githubUser: GitHubUser,
-  subscription: Subscription
-): Tenant {
+export function createTenant(githubUser: GitHubUser, subscription: Subscription): Tenant {
   const tenantId = generateTenantId(githubUser);
-  const storageNamespace = generateStorageNamespace(
-    githubUser.login,
-    githubUser.id
-  );
-  
+  const storageNamespace = generateStorageNamespace(githubUser.login, githubUser.id);
+
   return {
     id: tenantId,
     githubUserId: githubUser.id,
     githubLogin: githubUser.login,
-    type: "user", // Could be "organization" if checking org membership
+    type: 'user', // Could be "organization" if checking org membership
     subscription,
     storageNamespace,
     createdAt: Date.now(),
@@ -103,7 +97,7 @@ export function createTenant(
 
 /**
  * Validate storage namespace
- * 
+ *
  * Ensures namespace follows Azure Blob Storage naming rules:
  * - 3-63 characters
  * - lowercase letters, numbers, and hyphens only
@@ -117,43 +111,40 @@ export function validateStorageNamespace(namespace: string): {
   if (namespace.length < 3 || namespace.length > 63) {
     return {
       valid: false,
-      error: "Namespace must be 3-63 characters",
+      error: 'Namespace must be 3-63 characters',
     };
   }
-  
+
   if (!/^[a-z0-9]/.test(namespace)) {
     return {
       valid: false,
-      error: "Namespace must start with a letter or number",
+      error: 'Namespace must start with a letter or number',
     };
   }
-  
+
   if (!/^[a-z0-9-]+$/.test(namespace)) {
     return {
       valid: false,
-      error: "Namespace can only contain lowercase letters, numbers, and hyphens",
+      error: 'Namespace can only contain lowercase letters, numbers, and hyphens',
     };
   }
-  
+
   if (/--/.test(namespace)) {
     return {
       valid: false,
-      error: "Namespace cannot contain consecutive hyphens",
+      error: 'Namespace cannot contain consecutive hyphens',
     };
   }
-  
+
   return { valid: true };
 }
 
 /**
  * Get storage container name for an app
  */
-export function getAppStorageContainer(
-  tenantNamespace: string,
-  appId: string
-): string {
+export function getAppStorageContainer(tenantNamespace: string, appId: string): string {
   // Sanitize app ID
-  const sanitizedAppId = appId.toLowerCase().replace(/[^a-z0-9]/g, "-");
+  const sanitizedAppId = appId.toLowerCase().replace(/[^a-z0-9]/g, '-');
   return `${tenantNamespace}-${sanitizedAppId}`;
 }
 
@@ -165,12 +156,12 @@ export interface ProvisioningResult {
    * Whether provisioning was successful
    */
   success: boolean;
-  
+
   /**
    * Tenant (if successful)
    */
   tenant?: Tenant;
-  
+
   /**
    * Error message (if failed)
    */
@@ -179,7 +170,7 @@ export interface ProvisioningResult {
 
 /**
  * Provision a new tenant
- * 
+ *
  * This would typically:
  * 1. Create storage containers
  * 2. Set up access policies
@@ -192,7 +183,7 @@ export async function provisionTenant(
 ): Promise<ProvisioningResult> {
   try {
     const tenant = createTenant(githubUser, subscription);
-    
+
     // Validate storage namespace
     const validation = validateStorageNamespace(tenant.storageNamespace);
     if (!validation.valid) {
@@ -201,17 +192,17 @@ export async function provisionTenant(
         error: validation.error,
       };
     }
-    
+
     // TODO: In production, this would:
     // 1. Create Azure Blob Storage container
     // 2. Set up access policies
     // 3. Store tenant metadata in database
     // 4. Send welcome email
     // 5. Log provisioning event
-    
+
     console.log(`Provisioned tenant: ${tenant.id}`);
     console.log(`Storage namespace: ${tenant.storageNamespace}`);
-    
+
     return {
       success: true,
       tenant,
@@ -226,7 +217,7 @@ export async function provisionTenant(
 
 /**
  * Get or create tenant
- * 
+ *
  * Checks if tenant exists, creates if not.
  */
 export async function getOrCreateTenant(
@@ -235,7 +226,7 @@ export async function getOrCreateTenant(
   tenantLookup: (id: string) => Promise<Tenant | null>
 ): Promise<Tenant> {
   const tenantId = generateTenantId(githubUser);
-  
+
   // Try to get existing tenant
   const existing = await tenantLookup(tenantId);
   if (existing) {
@@ -243,12 +234,12 @@ export async function getOrCreateTenant(
     existing.lastAccessedAt = Date.now();
     return existing;
   }
-  
+
   // Provision new tenant
   const result = await provisionTenant(githubUser, subscription);
   if (!result.success || !result.tenant) {
     throw new Error(`Failed to provision tenant: ${result.error}`);
   }
-  
+
   return result.tenant;
 }

package/src/cloud/relay/endpoints.ts

@@ -1,14 +1,10 @@
 /**
  * Azure Functions Relay Endpoints
- * 
+ *
  * HTTP-triggered Azure Functions for Praxis Cloud Relay.
  */
 
-import type {
-  CRDTSyncMessage,
-  UsageMetrics,
-  HealthCheckResponse,
-} from "../types.js";
+import type { CRDTSyncMessage, UsageMetrics, HealthCheckResponse } from '../types.js';
 
 /**
  * Azure Function context (simplified interface)
@@ -54,12 +50,12 @@ export async function healthEndpoint(
   context: AzureContext,
   _req: AzureHttpRequest
 ): Promise<AzureHttpResponse> {
-  context.log("Health check requested");
+  context.log('Health check requested');
 
   const response: HealthCheckResponse = {
-    status: "healthy",
+    status: 'healthy',
     timestamp: Date.now(),
-    version: "0.1.0",
+    version: '0.1.0',
     services: {
       relay: true,
       eventGrid: true,
@@ -70,7 +66,7 @@ export async function healthEndpoint(
 
   return {
     status: 200,
-    headers: { "Content-Type": "application/json" },
+    headers: { 'Content-Type': 'application/json' },
     body: response,
   };
 }
@@ -83,13 +79,13 @@ export async function syncEndpoint(
   context: AzureContext,
   req: AzureHttpRequest
 ): Promise<AzureHttpResponse> {
-  context.log("Sync request received");
+  context.log('Sync request received');
 
   // Validate request
-  if (req.method !== "POST") {
+  if (req.method !== 'POST') {
     return {
       status: 405,
-      body: { error: "Method not allowed" },
+      body: { error: 'Method not allowed' },
     };
   }
 
@@ -98,7 +94,7 @@ export async function syncEndpoint(
   if (!message || !message.appId) {
     return {
       status: 400,
-      body: { error: "Invalid sync message" },
+      body: { error: 'Invalid sync message' },
     };
   }
 
@@ -131,7 +127,7 @@ export async function syncEndpoint(
   // Return updated vector clock
   return {
     status: 200,
-    headers: { "Content-Type": "application/json" },
+    headers: { 'Content-Type': 'application/json' },
     body: {
       success: true,
       clock: message.clock,
@@ -148,14 +144,14 @@ export async function usageEndpoint(
   context: AzureContext,
   req: AzureHttpRequest
 ): Promise<AzureHttpResponse> {
-  context.log("Usage metrics requested");
+  context.log('Usage metrics requested');
 
   const appId = req.query.appId;
 
   if (!appId) {
     return {
       status: 400,
-      body: { error: "appId query parameter is required" },
+      body: { error: 'appId query parameter is required' },
     };
   }
 
@@ -164,13 +160,13 @@ export async function usageEndpoint(
   if (!usage) {
     return {
       status: 404,
-      body: { error: "No usage data found for this app" },
+      body: { error: 'No usage data found for this app' },
     };
   }
 
   return {
     status: 200,
-    headers: { "Content-Type": "application/json" },
+    headers: { 'Content-Type': 'application/json' },
     body: usage,
   };
 }
@@ -183,14 +179,14 @@ export async function statsEndpoint(
   context: AzureContext,
   req: AzureHttpRequest
 ): Promise<AzureHttpResponse> {
-  context.log("Stats requested");
+  context.log('Stats requested');
 
   const appId = req.query.appId;
 
   if (!appId) {
     return {
       status: 400,
-      body: { error: "appId query parameter is required" },
+      body: { error: 'appId query parameter is required' },
     };
   }
 
@@ -199,7 +195,7 @@ export async function statsEndpoint(
 
   return {
     status: 200,
-    headers: { "Content-Type": "application/json" },
+    headers: { 'Content-Type': 'application/json' },
     body: {
       appId,
       totalSyncs: syncs.length,
@@ -217,12 +213,12 @@ export async function eventsEndpoint(
   context: AzureContext,
   req: AzureHttpRequest
 ): Promise<AzureHttpResponse> {
-  context.log("Event forwarding requested");
+  context.log('Event forwarding requested');
 
-  if (req.method !== "POST") {
+  if (req.method !== 'POST') {
     return {
       status: 405,
-      body: { error: "Method not allowed" },
+      body: { error: 'Method not allowed' },
     };
   }
 
@@ -231,7 +227,7 @@ export async function eventsEndpoint(
   if (!appId || !events) {
     return {
       status: 400,
-      body: { error: "Invalid event forwarding request" },
+      body: { error: 'Invalid event forwarding request' },
     };
   }
 
@@ -241,7 +237,7 @@ export async function eventsEndpoint(
   // For now, just acknowledge receipt
   return {
     status: 200,
-    headers: { "Content-Type": "application/json" },
+    headers: { 'Content-Type': 'application/json' },
     body: {
       success: true,
       forwarded: events.length,
@@ -259,15 +255,15 @@ export async function schemaEndpoint(
   context: AzureContext,
   req: AzureHttpRequest
 ): Promise<AzureHttpResponse> {
-  context.log("Schema registry requested");
+  context.log('Schema registry requested');
 
-  if (req.method === "POST") {
+  if (req.method === 'POST') {
     const { appId, schema } = req.body as { appId: string; schema: unknown };
 
     if (!appId || !schema) {
       return {
         status: 400,
-        body: { error: "Invalid schema registration request" },
+        body: { error: 'Invalid schema registration request' },
       };
     }
 
@@ -275,7 +271,7 @@ export async function schemaEndpoint(
 
     return {
       status: 200,
-      headers: { "Content-Type": "application/json" },
+      headers: { 'Content-Type': 'application/json' },
       body: {
         success: true,
         schemaId: `${appId}-${Date.now()}`,
@@ -290,18 +286,18 @@ export async function schemaEndpoint(
   if (!appId) {
     return {
       status: 400,
-      body: { error: "appId query parameter is required" },
+      body: { error: 'appId query parameter is required' },
     };
   }
 
   // Return placeholder schema
   return {
     status: 200,
-    headers: { "Content-Type": "application/json" },
+    headers: { 'Content-Type': 'application/json' },
     body: {
       appId,
       schema: null,
-      message: "Schema not found",
+      message: 'Schema not found',
     },
   };
 }

package/src/cloud/relay/health/index.ts

@@ -2,7 +2,7 @@
  * Azure Function: Health Check
  */
 
-import { healthEndpoint } from "../endpoints.js";
+import { healthEndpoint } from '../endpoints.js';
 
 export default async function (context: any, req: any) {
   const response = await healthEndpoint(context, req);

package/src/cloud/relay/stats/index.ts

@@ -2,7 +2,7 @@
  * Azure Function: Stats
  */
 
-import { statsEndpoint } from "../endpoints.js";
+import { statsEndpoint } from '../endpoints.js';
 
 export default async function (context: any, req: any) {
   const response = await statsEndpoint(context, req);

package/src/cloud/relay/sync/index.ts

@@ -2,7 +2,7 @@
  * Azure Function: CRDT Sync
  */
 
-import { syncEndpoint } from "../endpoints.js";
+import { syncEndpoint } from '../endpoints.js';
 
 export default async function (context: any, req: any) {
   const response = await syncEndpoint(context, req);

package/src/cloud/relay/usage/index.ts

@@ -2,7 +2,7 @@
  * Azure Function: Usage Metrics
  */
 
-import { usageEndpoint } from "../endpoints.js";
+import { usageEndpoint } from '../endpoints.js';
 
 export default async function (context: any, req: any) {
   const response = await usageEndpoint(context, req);

package/src/cloud/sponsors.ts

@@ -1,11 +1,11 @@
 /**
  * GitHub Sponsors API Client
- * 
+ *
  * Client for checking GitHub Sponsors subscription status.
  */
 
-import type { Subscription } from "./billing.js";
-import { createSponsorSubscription, createFreeSubscription } from "./billing.js";
+import type { Subscription } from './billing.js';
+import { createSponsorSubscription, createFreeSubscription } from './billing.js';
 
 /**
  * GitHub Sponsors tier information
@@ -15,22 +15,22 @@ export interface SponsorTier {
    * Tier ID
    */
   id: string;
-  
+
   /**
    * Tier name
    */
   name: string;
-  
+
   /**
    * Monthly price in cents
    */
   monthlyPriceInCents: number;
-  
+
   /**
    * Tier description
    */
   description?: string;
-  
+
   /**
    * Whether this is a one-time sponsorship
    */
@@ -45,22 +45,22 @@ export interface Sponsorship {
    * Sponsor login
    */
   sponsorLogin: string;
-  
+
   /**
    * Sponsor ID
    */
   sponsorId: number;
-  
+
   /**
    * Tier information
    */
   tier: SponsorTier;
-  
+
   /**
    * Creation date
    */
   createdAt: string;
-  
+
   /**
    * Whether sponsorship is active
    */
@@ -73,12 +73,12 @@ export interface Sponsorship {
 export class GitHubSponsorsClient {
   private token: string;
   private accountLogin: string;
-  
+
   constructor(token: string, accountLogin: string) {
     this.token = token;
     this.accountLogin = accountLogin;
   }
-  
+
   /**
    * Get current user's sponsorship of the Praxis account
    */
@@ -122,12 +122,12 @@ export class GitHubSponsorsClient {
           }
         }
       `;
-      
-      const response = await fetch("https://api.github.com/graphql", {
-        method: "POST",
+
+      const response = await fetch('https://api.github.com/graphql', {
+        method: 'POST',
         headers: {
           Authorization: `Bearer ${this.token}`,
-          "Content-Type": "application/json",
+          'Content-Type': 'application/json',
         },
         body: JSON.stringify({
           query,
@@ -137,27 +137,27 @@ export class GitHubSponsorsClient {
           },
         }),
       });
-      
+
       if (!response.ok) {
         throw new Error(`GitHub API error: ${response.statusText}`);
       }
-      
-      const data = await response.json() as any;
-      
+
+      const data = (await response.json()) as any;
+
       if (data.errors) {
         throw new Error(`GraphQL error: ${JSON.stringify(data.errors)}`);
       }
-      
+
       // Check if user sponsors the Praxis account
       const sponsorships = data.data?.user?.sponsorshipsAsSponsor?.nodes || [];
       const praxisSponsorship = sponsorships.find(
         (s: any) => s.sponsorable?.login === this.accountLogin
       );
-      
+
       if (!praxisSponsorship) {
         return null;
       }
-      
+
       return {
         sponsorLogin: userLogin,
         sponsorId: data.data.user.id,
@@ -172,27 +172,24 @@ export class GitHubSponsorsClient {
         isActive: praxisSponsorship.isActive,
       };
     } catch (error) {
-      console.error("Failed to get sponsorship:", error);
+      console.error('Failed to get sponsorship:', error);
       return null;
     }
   }
-  
+
   /**
    * Get subscription from sponsorship
    */
   async getSubscription(userLogin: string): Promise<Subscription> {
     const sponsorship = await this.getSponsorship(userLogin);
-    
+
     if (!sponsorship || !sponsorship.isActive) {
       return createFreeSubscription();
     }
-    
-    return createSponsorSubscription(
-      sponsorship.tier.name,
-      sponsorship.tier.monthlyPriceInCents
-    );
+
+    return createSponsorSubscription(sponsorship.tier.name, sponsorship.tier.monthlyPriceInCents);
   }
-  
+
   /**
    * Check if user is a sponsor
    */
@@ -207,7 +204,7 @@ export class GitHubSponsorsClient {
  */
 export function createSponsorsClient(
   token: string,
-  accountLogin: string = "plures"
+  accountLogin: string = 'plures'
 ): GitHubSponsorsClient {
   return new GitHubSponsorsClient(token, accountLogin);
 }