@plures/praxis 0.2.0

package/dist/cloud/provisioning.d.ts

@@ -0,0 +1,110 @@
+/**
+ * Auto-Provisioning
+ *
+ * Automatic tenant/storage provisioning based on GitHub identity.
+ */
+import type { GitHubUser } from "./types.js";
+import type { Subscription } from "./billing.js";
+/**
+ * Tenant information
+ */
+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";
+    /**
+     * Subscription
+     */
+    subscription: Subscription;
+    /**
+     * Storage namespace
+     */
+    storageNamespace: string;
+    /**
+     * Creation timestamp
+     */
+    createdAt: number;
+    /**
+     * Last accessed timestamp
+     */
+    lastAccessedAt: number;
+}
+/**
+ * Generate a storage namespace from GitHub login
+ *
+ * Namespace format: gh-{login}-{hash}
+ * This ensures uniqueness and follows Azure Blob Storage naming rules.
+ */
+export declare function generateStorageNamespace(githubLogin: string, userId: number): string;
+/**
+ * Generate tenant ID from GitHub user
+ */
+export declare function generateTenantId(githubUser: GitHubUser): string;
+/**
+ * Create a tenant from GitHub user
+ */
+export declare function createTenant(githubUser: GitHubUser, subscription: Subscription): Tenant;
+/**
+ * Validate storage namespace
+ *
+ * Ensures namespace follows Azure Blob Storage naming rules:
+ * - 3-63 characters
+ * - lowercase letters, numbers, and hyphens only
+ * - must start with letter or number
+ * - no consecutive hyphens
+ */
+export declare function validateStorageNamespace(namespace: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Get storage container name for an app
+ */
+export declare function getAppStorageContainer(tenantNamespace: string, appId: string): string;
+/**
+ * Provisioning result
+ */
+export interface ProvisioningResult {
+    /**
+     * Whether provisioning was successful
+     */
+    success: boolean;
+    /**
+     * Tenant (if successful)
+     */
+    tenant?: Tenant;
+    /**
+     * Error message (if failed)
+     */
+    error?: string;
+}
+/**
+ * Provision a new tenant
+ *
+ * This would typically:
+ * 1. Create storage containers
+ * 2. Set up access policies
+ * 3. Initialize tenant metadata
+ * 4. Register with billing system
+ */
+export declare function provisionTenant(githubUser: GitHubUser, subscription: Subscription): Promise<ProvisioningResult>;
+/**
+ * Get or create tenant
+ *
+ * Checks if tenant exists, creates if not.
+ */
+export declare function getOrCreateTenant(githubUser: GitHubUser, subscription: Subscription, tenantLookup: (id: string) => Promise<Tenant | null>): Promise<Tenant>;
+//# sourceMappingURL=provisioning.d.ts.map

package/dist/cloud/provisioning.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisioning.d.ts","sourceRoot":"","sources":["../../src/cloud/provisioning.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,cAAc,CAAC;IAE9B;;OAEG;IACH,YAAY,EAAE,YAAY,CAAC;IAE3B;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CASpF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,GACzB,MAAM,CAiBR;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG;IAC3D,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CA8BA;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,GACZ,MAAM,CAIR;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,kBAAkB,CAAC,CAiC7B;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GACnD,OAAO,CAAC,MAAM,CAAC,CAkBjB"}

package/dist/cloud/provisioning.js

@@ -0,0 +1,148 @@
+/**
+ * Auto-Provisioning
+ *
+ * Automatic tenant/storage provisioning based on GitHub identity.
+ */
+/**
+ * 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, userId) {
+    // Sanitize login: lowercase, replace non-alphanumeric with hyphens
+    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");
+    // Combine with prefix
+    return `gh-${sanitized}-${hash}`;
+}
+/**
+ * Generate tenant ID from GitHub user
+ */
+export function generateTenantId(githubUser) {
+    return `github-${githubUser.id}`;
+}
+/**
+ * Create a tenant from GitHub user
+ */
+export function createTenant(githubUser, subscription) {
+    const tenantId = generateTenantId(githubUser);
+    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
+        subscription,
+        storageNamespace,
+        createdAt: Date.now(),
+        lastAccessedAt: Date.now(),
+    };
+}
+/**
+ * Validate storage namespace
+ *
+ * Ensures namespace follows Azure Blob Storage naming rules:
+ * - 3-63 characters
+ * - lowercase letters, numbers, and hyphens only
+ * - must start with letter or number
+ * - no consecutive hyphens
+ */
+export function validateStorageNamespace(namespace) {
+    if (namespace.length < 3 || namespace.length > 63) {
+        return {
+            valid: false,
+            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",
+        };
+    }
+    if (!/^[a-z0-9-]+$/.test(namespace)) {
+        return {
+            valid: false,
+            error: "Namespace can only contain lowercase letters, numbers, and hyphens",
+        };
+    }
+    if (/--/.test(namespace)) {
+        return {
+            valid: false,
+            error: "Namespace cannot contain consecutive hyphens",
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Get storage container name for an app
+ */
+export function getAppStorageContainer(tenantNamespace, appId) {
+    // Sanitize app ID
+    const sanitizedAppId = appId.toLowerCase().replace(/[^a-z0-9]/g, "-");
+    return `${tenantNamespace}-${sanitizedAppId}`;
+}
+/**
+ * Provision a new tenant
+ *
+ * This would typically:
+ * 1. Create storage containers
+ * 2. Set up access policies
+ * 3. Initialize tenant metadata
+ * 4. Register with billing system
+ */
+export async function provisionTenant(githubUser, subscription) {
+    try {
+        const tenant = createTenant(githubUser, subscription);
+        // Validate storage namespace
+        const validation = validateStorageNamespace(tenant.storageNamespace);
+        if (!validation.valid) {
+            return {
+                success: false,
+                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,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Get or create tenant
+ *
+ * Checks if tenant exists, creates if not.
+ */
+export async function getOrCreateTenant(githubUser, subscription, tenantLookup) {
+    const tenantId = generateTenantId(githubUser);
+    // Try to get existing tenant
+    const existing = await tenantLookup(tenantId);
+    if (existing) {
+        // Update last accessed time
+        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;
+}
+//# sourceMappingURL=provisioning.js.map

package/dist/cloud/provisioning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provisioning.js","sourceRoot":"","sources":["../../src/cloud/provisioning.ts"],"names":[],"mappings":"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"}

package/dist/cloud/relay/endpoints.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Azure Functions Relay Endpoints
+ *
+ * HTTP-triggered Azure Functions for Praxis Cloud Relay.
+ */
+/**
+ * Azure Function context (simplified interface)
+ */
+export interface AzureContext {
+    log: (message: string) => void;
+    done: (err?: Error, result?: unknown) => void;
+}
+/**
+ * Azure HTTP request
+ */
+export interface AzureHttpRequest {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    query: Record<string, string>;
+    body?: unknown;
+}
+/**
+ * Azure HTTP response
+ */
+export interface AzureHttpResponse {
+    status: number;
+    headers?: Record<string, string>;
+    body?: unknown;
+}
+/**
+ * Health check endpoint
+ * GET /health
+ */
+export declare function healthEndpoint(context: AzureContext, _req: AzureHttpRequest): Promise<AzureHttpResponse>;
+/**
+ * CRDT sync endpoint
+ * POST /sync
+ */
+export declare function syncEndpoint(context: AzureContext, req: AzureHttpRequest): Promise<AzureHttpResponse>;
+/**
+ * Usage metrics endpoint
+ * GET /usage?appId=<appId>
+ */
+export declare function usageEndpoint(context: AzureContext, req: AzureHttpRequest): Promise<AzureHttpResponse>;
+/**
+ * Stats endpoint for aggregated metrics
+ * GET /stats?appId=<appId>
+ */
+export declare function statsEndpoint(context: AzureContext, req: AzureHttpRequest): Promise<AzureHttpResponse>;
+/**
+ * Event forwarding endpoint
+ * POST /events
+ */
+export declare function eventsEndpoint(context: AzureContext, req: AzureHttpRequest): Promise<AzureHttpResponse>;
+/**
+ * Schema registry endpoint
+ * GET /schema?appId=<appId>
+ * POST /schema (to register a schema)
+ */
+export declare function schemaEndpoint(context: AzureContext, req: AzureHttpRequest): Promise<AzureHttpResponse>;
+//# sourceMappingURL=endpoints.d.ts.map

package/dist/cloud/relay/endpoints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.d.ts","sourceRoot":"","sources":["../../../src/cloud/relay/endpoints.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAUD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAoB5B;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAwD5B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,iBAAiB,CAAC,CA0B5B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAyB5B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,iBAAiB,CAAC,CAgC5B;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,YAAY,EACrB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,iBAAiB,CAAC,CA8C5B"}

package/dist/cloud/relay/endpoints.js

@@ -0,0 +1,217 @@
+/**
+ * Azure Functions Relay Endpoints
+ *
+ * HTTP-triggered Azure Functions for Praxis Cloud Relay.
+ */
+/**
+ * In-memory storage for demo (replace with Azure Storage in production)
+ */
+const storage = {
+    syncs: new Map(),
+    usage: new Map(),
+};
+/**
+ * Health check endpoint
+ * GET /health
+ */
+export async function healthEndpoint(context, _req) {
+    context.log("Health check requested");
+    const response = {
+        status: "healthy",
+        timestamp: Date.now(),
+        version: "0.1.0",
+        services: {
+            relay: true,
+            eventGrid: true,
+            storage: true,
+            auth: true,
+        },
+    };
+    return {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+        body: response,
+    };
+}
+/**
+ * CRDT sync endpoint
+ * POST /sync
+ */
+export async function syncEndpoint(context, req) {
+    context.log("Sync request received");
+    // Validate request
+    if (req.method !== "POST") {
+        return {
+            status: 405,
+            body: { error: "Method not allowed" },
+        };
+    }
+    const message = req.body;
+    if (!message || !message.appId) {
+        return {
+            status: 400,
+            body: { error: "Invalid sync message" },
+        };
+    }
+    // Store sync message
+    const appSyncs = storage.syncs.get(message.appId) || [];
+    appSyncs.push(message);
+    storage.syncs.set(message.appId, appSyncs);
+    // Update usage metrics
+    const usage = storage.usage.get(message.appId) || {
+        appId: message.appId,
+        syncCount: 0,
+        eventCount: 0,
+        factCount: 0,
+        storageBytes: 0,
+        periodStart: Date.now(),
+        periodEnd: Date.now(),
+    };
+    usage.syncCount++;
+    usage.eventCount += message.events?.length || 0;
+    usage.factCount += message.facts?.length || 0;
+    usage.storageBytes += JSON.stringify(message).length;
+    usage.periodEnd = Date.now();
+    storage.usage.set(message.appId, usage);
+    context.log(`Synced for app ${message.appId}: ${usage.syncCount} total syncs`);
+    // Return updated vector clock
+    return {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+        body: {
+            success: true,
+            clock: message.clock,
+            timestamp: Date.now(),
+        },
+    };
+}
+/**
+ * Usage metrics endpoint
+ * GET /usage?appId=<appId>
+ */
+export async function usageEndpoint(context, req) {
+    context.log("Usage metrics requested");
+    const appId = req.query.appId;
+    if (!appId) {
+        return {
+            status: 400,
+            body: { error: "appId query parameter is required" },
+        };
+    }
+    const usage = storage.usage.get(appId);
+    if (!usage) {
+        return {
+            status: 404,
+            body: { error: "No usage data found for this app" },
+        };
+    }
+    return {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+        body: usage,
+    };
+}
+/**
+ * Stats endpoint for aggregated metrics
+ * GET /stats?appId=<appId>
+ */
+export async function statsEndpoint(context, req) {
+    context.log("Stats requested");
+    const appId = req.query.appId;
+    if (!appId) {
+        return {
+            status: 400,
+            body: { error: "appId query parameter is required" },
+        };
+    }
+    const usage = storage.usage.get(appId);
+    const syncs = storage.syncs.get(appId) || [];
+    return {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+        body: {
+            appId,
+            totalSyncs: syncs.length,
+            usage: usage || null,
+            lastSync: syncs.length > 0 ? syncs[syncs.length - 1].timestamp : null,
+        },
+    };
+}
+/**
+ * Event forwarding endpoint
+ * POST /events
+ */
+export async function eventsEndpoint(context, req) {
+    context.log("Event forwarding requested");
+    if (req.method !== "POST") {
+        return {
+            status: 405,
+            body: { error: "Method not allowed" },
+        };
+    }
+    const { appId, events } = req.body;
+    if (!appId || !events) {
+        return {
+            status: 400,
+            body: { error: "Invalid event forwarding request" },
+        };
+    }
+    context.log(`Forwarding ${events.length} events for app ${appId}`);
+    // In production, publish to Azure Event Grid / Service Bus
+    // For now, just acknowledge receipt
+    return {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+        body: {
+            success: true,
+            forwarded: events.length,
+            timestamp: Date.now(),
+        },
+    };
+}
+/**
+ * Schema registry endpoint
+ * GET /schema?appId=<appId>
+ * POST /schema (to register a schema)
+ */
+export async function schemaEndpoint(context, req) {
+    context.log("Schema registry requested");
+    if (req.method === "POST") {
+        const { appId, schema } = req.body;
+        if (!appId || !schema) {
+            return {
+                status: 400,
+                body: { error: "Invalid schema registration request" },
+            };
+        }
+        context.log(`Schema registered for app ${appId}`);
+        return {
+            status: 200,
+            headers: { "Content-Type": "application/json" },
+            body: {
+                success: true,
+                schemaId: `${appId}-${Date.now()}`,
+                timestamp: Date.now(),
+            },
+        };
+    }
+    // GET request
+    const appId = req.query.appId;
+    if (!appId) {
+        return {
+            status: 400,
+            body: { error: "appId query parameter is required" },
+        };
+    }
+    // Return placeholder schema
+    return {
+        status: 200,
+        headers: { "Content-Type": "application/json" },
+        body: {
+            appId,
+            schema: null,
+            message: "Schema not found",
+        },
+    };
+}
+//# sourceMappingURL=endpoints.js.map

package/dist/cloud/relay/endpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoints.js","sourceRoot":"","sources":["../../../src/cloud/relay/endpoints.ts"],"names":[],"mappings":"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"}

package/dist/cloud/relay/health/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Azure Function: Health Check
+ */
+export default function (context: any, req: any): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cloud/relay/health/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cloud/relay/health/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,yBAA+B,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,iBAGpD"}

package/dist/cloud/relay/health/index.js

@@ -0,0 +1,9 @@
+/**
+ * Azure Function: Health Check
+ */
+import { healthEndpoint } from "../endpoints.js";
+export default async function (context, req) {
+    const response = await healthEndpoint(context, req);
+    context.res = response;
+}
+//# sourceMappingURL=index.js.map

package/dist/cloud/relay/health/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cloud/relay/health/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,OAAO,CAAC,KAAK,WAAW,OAAY,EAAE,GAAQ;IACnD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,GAAG,QAAQ,CAAC;AACzB,CAAC"}

package/dist/cloud/relay/stats/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Azure Function: Stats
+ */
+export default function (context: any, req: any): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cloud/relay/stats/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cloud/relay/stats/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,yBAA+B,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,iBAGpD"}

package/dist/cloud/relay/stats/index.js

@@ -0,0 +1,9 @@
+/**
+ * Azure Function: Stats
+ */
+import { statsEndpoint } from "../endpoints.js";
+export default async function (context, req) {
+    const response = await statsEndpoint(context, req);
+    context.res = response;
+}
+//# sourceMappingURL=index.js.map

package/dist/cloud/relay/stats/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cloud/relay/stats/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,CAAC,OAAO,CAAC,KAAK,WAAW,OAAY,EAAE,GAAQ;IACnD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,GAAG,QAAQ,CAAC;AACzB,CAAC"}

package/dist/cloud/relay/sync/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Azure Function: CRDT Sync
+ */
+export default function (context: any, req: any): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cloud/relay/sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cloud/relay/sync/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,yBAA+B,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,iBAGpD"}

package/dist/cloud/relay/sync/index.js

@@ -0,0 +1,9 @@
+/**
+ * Azure Function: CRDT Sync
+ */
+import { syncEndpoint } from "../endpoints.js";
+export default async function (context, req) {
+    const response = await syncEndpoint(context, req);
+    context.res = response;
+}
+//# sourceMappingURL=index.js.map

package/dist/cloud/relay/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cloud/relay/sync/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,CAAC,OAAO,CAAC,KAAK,WAAW,OAAY,EAAE,GAAQ;IACnD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,GAAG,QAAQ,CAAC;AACzB,CAAC"}

package/dist/cloud/relay/usage/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Azure Function: Usage Metrics
+ */
+export default function (context: any, req: any): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cloud/relay/usage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cloud/relay/usage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,yBAA+B,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,iBAGpD"}

package/dist/cloud/relay/usage/index.js

@@ -0,0 +1,9 @@
+/**
+ * Azure Function: Usage Metrics
+ */
+import { usageEndpoint } from "../endpoints.js";
+export default async function (context, req) {
+    const response = await usageEndpoint(context, req);
+    context.res = response;
+}
+//# sourceMappingURL=index.js.map

package/dist/cloud/relay/usage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/cloud/relay/usage/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,CAAC,OAAO,CAAC,KAAK,WAAW,OAAY,EAAE,GAAQ;IACnD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,GAAG,QAAQ,CAAC;AACzB,CAAC"}