@plures/praxis 0.2.0

package/dist/cloud/auth.d.ts

@@ -0,0 +1,51 @@
+/**
+ * GitHub OAuth Authentication
+ *
+ * GitHub OAuth integration for Praxis Cloud Relay identity.
+ */
+import type { AuthResult, GitHubUser } from "./types.js";
+/**
+ * GitHub OAuth configuration
+ */
+export interface GitHubOAuthConfig {
+    clientId: string;
+    clientSecret?: string;
+    redirectUri?: string;
+    scope?: string;
+}
+/**
+ * GitHub OAuth client
+ */
+export declare class GitHubOAuth {
+    private config;
+    constructor(config: GitHubOAuthConfig);
+    /**
+     * Get the OAuth authorization URL
+     */
+    getAuthorizationUrl(state?: string): string;
+    /**
+     * Exchange authorization code for access token
+     */
+    exchangeCode(code: string): Promise<AuthResult>;
+    /**
+     * Get user information from GitHub
+     */
+    getUserInfo(token: string): Promise<GitHubUser>;
+    /**
+     * Verify a token is valid
+     */
+    verifyToken(token: string): Promise<boolean>;
+    /**
+     * Generate a random state parameter for CSRF protection
+     */
+    private generateState;
+}
+/**
+ * Create a GitHub OAuth client
+ */
+export declare function createGitHubOAuth(config: GitHubOAuthConfig): GitHubOAuth;
+/**
+ * Authenticate with GitHub OAuth device flow (for CLI)
+ */
+export declare function authenticateWithDeviceFlow(clientId: string): Promise<AuthResult>;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/cloud/auth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,iBAAiB;IAIrC;;OAEG;IACH,mBAAmB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAc3C;;OAEG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAkDrD;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAuBrD;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASlD;;OAEG;IACH,OAAO,CAAC,aAAa;CActB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAExE;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CA6ErB"}

package/dist/cloud/auth.js

@@ -0,0 +1,194 @@
+/**
+ * GitHub OAuth Authentication
+ *
+ * GitHub OAuth integration for Praxis Cloud Relay identity.
+ */
+/**
+ * GitHub OAuth client
+ */
+export class GitHubOAuth {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Get the OAuth authorization URL
+     */
+    getAuthorizationUrl(state) {
+        const params = new URLSearchParams({
+            client_id: this.config.clientId,
+            scope: this.config.scope || "read:user user:email",
+            state: state || this.generateState(),
+        });
+        if (this.config.redirectUri) {
+            params.set("redirect_uri", this.config.redirectUri);
+        }
+        return `https://github.com/login/oauth/authorize?${params.toString()}`;
+    }
+    /**
+     * Exchange authorization code for access token
+     */
+    async exchangeCode(code) {
+        if (!this.config.clientSecret) {
+            throw new Error("Client secret is required for code exchange");
+        }
+        try {
+            const response = await fetch("https://github.com/login/oauth/access_token", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
+                },
+                body: JSON.stringify({
+                    client_id: this.config.clientId,
+                    client_secret: this.config.clientSecret,
+                    code,
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`Token exchange failed: ${response.statusText}`);
+            }
+            const data = await response.json();
+            if (data.error) {
+                throw new Error(`GitHub OAuth error: ${data.error_description || data.error}`);
+            }
+            // Get user info
+            const user = await this.getUserInfo(data.access_token);
+            return {
+                success: true,
+                token: data.access_token,
+                user,
+                expiresAt: data.expires_in
+                    ? Date.now() + data.expires_in * 1000
+                    : undefined,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+            };
+        }
+    }
+    /**
+     * Get user information from GitHub
+     */
+    async getUserInfo(token) {
+        const response = await fetch("https://api.github.com/user", {
+            headers: {
+                Authorization: `Bearer ${token}`,
+                Accept: "application/vnd.github.v3+json",
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to get user info: ${response.statusText}`);
+        }
+        const data = await response.json();
+        return {
+            id: data.id,
+            login: data.login,
+            email: data.email,
+            name: data.name,
+            avatarUrl: data.avatar_url,
+        };
+    }
+    /**
+     * Verify a token is valid
+     */
+    async verifyToken(token) {
+        try {
+            await this.getUserInfo(token);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Generate a random state parameter for CSRF protection
+     */
+    generateState() {
+        const array = new Uint8Array(16);
+        if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+            crypto.getRandomValues(array);
+        }
+        else {
+            // Fallback for Node.js
+            for (let i = 0; i < array.length; i++) {
+                array[i] = Math.floor(Math.random() * 256);
+            }
+        }
+        return Array.from(array, (byte) => byte.toString(16).padStart(2, "0")).join("");
+    }
+}
+/**
+ * Create a GitHub OAuth client
+ */
+export function createGitHubOAuth(config) {
+    return new GitHubOAuth(config);
+}
+/**
+ * Authenticate with GitHub OAuth device flow (for CLI)
+ */
+export async function authenticateWithDeviceFlow(clientId) {
+    try {
+        // Request device code
+        const deviceResponse = await fetch("https://github.com/login/device/code", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "application/json",
+            },
+            body: JSON.stringify({
+                client_id: clientId,
+                scope: "read:user user:email",
+            }),
+        });
+        if (!deviceResponse.ok) {
+            throw new Error(`Device flow initiation failed: ${deviceResponse.statusText}`);
+        }
+        const deviceData = await deviceResponse.json();
+        console.log("\nTo authenticate with GitHub:");
+        console.log(`1. Visit: ${deviceData.verification_uri}`);
+        console.log(`2. Enter code: ${deviceData.user_code}`);
+        console.log("\nWaiting for authentication...\n");
+        // Poll for access token
+        const interval = deviceData.interval * 1000 || 5000;
+        const expiresAt = Date.now() + deviceData.expires_in * 1000;
+        while (Date.now() < expiresAt) {
+            await new Promise((resolve) => setTimeout(resolve, interval));
+            const tokenResponse = await fetch("https://github.com/login/oauth/access_token", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Accept: "application/json",
+                },
+                body: JSON.stringify({
+                    client_id: clientId,
+                    device_code: deviceData.device_code,
+                    grant_type: "urn:ietf:params:oauth:grant-type:device_code",
+                }),
+            });
+            const tokenData = await tokenResponse.json();
+            if (tokenData.access_token) {
+                // Get user info
+                const oauth = new GitHubOAuth({ clientId });
+                const user = await oauth.getUserInfo(tokenData.access_token);
+                return {
+                    success: true,
+                    token: tokenData.access_token,
+                    user,
+                };
+            }
+            if (tokenData.error && tokenData.error !== "authorization_pending") {
+                throw new Error(`Authentication failed: ${tokenData.error_description || tokenData.error}`);
+            }
+        }
+        throw new Error("Authentication timeout");
+    }
+    catch (error) {
+        return {
+            success: false,
+        };
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/cloud/auth.js.map

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

package/dist/cloud/billing.d.ts

@@ -0,0 +1,184 @@
+/**
+ * GitHub Sponsors and Marketplace Billing
+ *
+ * Types and utilities for GitHub-based monetization.
+ */
+/**
+ * Praxis Cloud subscription tiers
+ */
+export declare enum SubscriptionTier {
+    /**
+     * Free tier - limited usage
+     */
+    FREE = "free",
+    /**
+     * Solo tier - individual developers via GitHub Sponsors
+     */
+    SOLO = "solo",
+    /**
+     * Team tier - small teams via GitHub Sponsors
+     */
+    TEAM = "team",
+    /**
+     * Enterprise tier - self-service enterprise via GitHub Sponsors/Marketplace
+     */
+    ENTERPRISE = "enterprise"
+}
+/**
+ * Billing provider type
+ */
+export declare enum BillingProvider {
+    /**
+     * GitHub Sponsors
+     */
+    SPONSORS = "sponsors",
+    /**
+     * GitHub Marketplace (SaaS)
+     */
+    MARKETPLACE = "marketplace",
+    /**
+     * Free tier (no billing)
+     */
+    NONE = "none"
+}
+/**
+ * Subscription status
+ */
+export declare enum SubscriptionStatus {
+    /**
+     * Active subscription
+     */
+    ACTIVE = "active",
+    /**
+     * Subscription cancelled, but still valid until period end
+     */
+    CANCELLED = "cancelled",
+    /**
+     * Subscription expired or payment failed
+     */
+    EXPIRED = "expired",
+    /**
+     * No subscription
+     */
+    NONE = "none"
+}
+/**
+ * Tier limits for different subscription levels
+ */
+export interface TierLimits {
+    /**
+     * Maximum sync operations per month
+     */
+    maxSyncsPerMonth: number;
+    /**
+     * Maximum storage in bytes
+     */
+    maxStorageBytes: number;
+    /**
+     * Maximum number of team members (null = unlimited)
+     */
+    maxTeamMembers: number | null;
+    /**
+     * Maximum number of apps/projects
+     */
+    maxApps: number;
+    /**
+     * Support level
+     */
+    supportLevel: "community" | "standard" | "priority";
+}
+/**
+ * Subscription information
+ */
+export interface Subscription {
+    /**
+     * Subscription tier
+     */
+    tier: SubscriptionTier;
+    /**
+     * Subscription status
+     */
+    status: SubscriptionStatus;
+    /**
+     * Billing provider
+     */
+    provider: BillingProvider;
+    /**
+     * GitHub sponsor tier ID (if applicable)
+     */
+    sponsorTierId?: string;
+    /**
+     * GitHub Marketplace plan ID (if applicable)
+     */
+    marketplacePlanId?: number;
+    /**
+     * Subscription start date
+     */
+    startDate: number;
+    /**
+     * Current period end date
+     */
+    periodEnd?: number;
+    /**
+     * Whether subscription auto-renews
+     */
+    autoRenew: boolean;
+    /**
+     * Usage limits for this tier
+     */
+    limits: TierLimits;
+}
+/**
+ * Billing event type
+ */
+export interface BillingEvent {
+    /**
+     * Event type
+     */
+    type: "subscription_created" | "subscription_cancelled" | "subscription_renewed" | "tier_changed";
+    /**
+     * Timestamp
+     */
+    timestamp: number;
+    /**
+     * User/organization ID
+     */
+    userId: number;
+    /**
+     * Old subscription (for changes)
+     */
+    oldSubscription?: Subscription;
+    /**
+     * New subscription
+     */
+    newSubscription: Subscription;
+}
+/**
+ * Default tier limits
+ */
+export declare const TIER_LIMITS: Record<SubscriptionTier, TierLimits>;
+/**
+ * Check if a user has access to a specific tier
+ */
+export declare function hasAccessToTier(subscription: Subscription, requiredTier: SubscriptionTier): boolean;
+/**
+ * Check if usage is within tier limits
+ */
+export declare function checkUsageLimits(subscription: Subscription, usage: {
+    syncCount: number;
+    storageBytes: number;
+    teamMembers: number;
+    appCount: number;
+}): {
+    withinLimits: boolean;
+    violations: string[];
+};
+/**
+ * Create a free tier subscription
+ */
+export declare function createFreeSubscription(): Subscription;
+/**
+ * Create a subscription from GitHub Sponsors tier
+ */
+export declare function createSponsorSubscription(tierName: string, monthlyPriceInCents: number): Subscription;
+//# sourceMappingURL=billing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/cloud/billing.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,gBAAgB;IAC1B;;OAEG;IACH,IAAI,SAAS;IAEb;;OAEG;IACH,IAAI,SAAS;IAEb;;OAEG;IACH,IAAI,SAAS;IAEb;;OAEG;IACH,UAAU,eAAe;CAC1B;AAED;;GAEG;AACH,oBAAY,eAAe;IACzB;;OAEG;IACH,QAAQ,aAAa;IAErB;;OAEG;IACH,WAAW,gBAAgB;IAE3B;;OAEG;IACH,IAAI,SAAS;CACd;AAED;;GAEG;AACH,oBAAY,kBAAkB;IAC5B;;OAEG;IACH,MAAM,WAAW;IAEjB;;OAEG;IACH,SAAS,cAAc;IAEvB;;OAEG;IACH,OAAO,YAAY;IAEnB;;OAEG;IACH,IAAI,SAAS;CACd;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,YAAY,EAAE,WAAW,GAAG,UAAU,GAAG,UAAU,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,gBAAgB,CAAC;IAEvB;;OAEG;IACH,MAAM,EAAE,kBAAkB,CAAC;IAE3B;;OAEG;IACH,QAAQ,EAAE,eAAe,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,UAAU,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,sBAAsB,GAAG,wBAAwB,GAAG,sBAAsB,GAAG,cAAc,CAAC;IAElG;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,eAAe,CAAC,EAAE,YAAY,CAAC;IAE/B;;OAEG;IACH,eAAe,EAAE,YAAY,CAAC;CAC/B;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,gBAAgB,EAAE,UAAU,CA6B5D,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,gBAAgB,GAC7B,OAAO,CAgBT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,GACA;IACD,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAkCA;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,YAAY,CASrD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,mBAAmB,EAAE,MAAM,GAC1B,YAAY,CAqBd"}

package/dist/cloud/billing.js

@@ -0,0 +1,179 @@
+/**
+ * GitHub Sponsors and Marketplace Billing
+ *
+ * Types and utilities for GitHub-based monetization.
+ */
+/**
+ * Praxis Cloud subscription tiers
+ */
+export var SubscriptionTier;
+(function (SubscriptionTier) {
+    /**
+     * Free tier - limited usage
+     */
+    SubscriptionTier["FREE"] = "free";
+    /**
+     * Solo tier - individual developers via GitHub Sponsors
+     */
+    SubscriptionTier["SOLO"] = "solo";
+    /**
+     * Team tier - small teams via GitHub Sponsors
+     */
+    SubscriptionTier["TEAM"] = "team";
+    /**
+     * Enterprise tier - self-service enterprise via GitHub Sponsors/Marketplace
+     */
+    SubscriptionTier["ENTERPRISE"] = "enterprise";
+})(SubscriptionTier || (SubscriptionTier = {}));
+/**
+ * Billing provider type
+ */
+export var BillingProvider;
+(function (BillingProvider) {
+    /**
+     * GitHub Sponsors
+     */
+    BillingProvider["SPONSORS"] = "sponsors";
+    /**
+     * GitHub Marketplace (SaaS)
+     */
+    BillingProvider["MARKETPLACE"] = "marketplace";
+    /**
+     * Free tier (no billing)
+     */
+    BillingProvider["NONE"] = "none";
+})(BillingProvider || (BillingProvider = {}));
+/**
+ * Subscription status
+ */
+export var SubscriptionStatus;
+(function (SubscriptionStatus) {
+    /**
+     * Active subscription
+     */
+    SubscriptionStatus["ACTIVE"] = "active";
+    /**
+     * Subscription cancelled, but still valid until period end
+     */
+    SubscriptionStatus["CANCELLED"] = "cancelled";
+    /**
+     * Subscription expired or payment failed
+     */
+    SubscriptionStatus["EXPIRED"] = "expired";
+    /**
+     * No subscription
+     */
+    SubscriptionStatus["NONE"] = "none";
+})(SubscriptionStatus || (SubscriptionStatus = {}));
+/**
+ * Default tier limits
+ */
+export const TIER_LIMITS = {
+    [SubscriptionTier.FREE]: {
+        maxSyncsPerMonth: 1000,
+        maxStorageBytes: 10 * 1024 * 1024, // 10 MB
+        maxTeamMembers: 1,
+        maxApps: 1,
+        supportLevel: "community",
+    },
+    [SubscriptionTier.SOLO]: {
+        maxSyncsPerMonth: 50000,
+        maxStorageBytes: 1024 * 1024 * 1024, // 1 GB
+        maxTeamMembers: 1,
+        maxApps: 10,
+        supportLevel: "standard",
+    },
+    [SubscriptionTier.TEAM]: {
+        maxSyncsPerMonth: 500000,
+        maxStorageBytes: 10 * 1024 * 1024 * 1024, // 10 GB
+        maxTeamMembers: 10,
+        maxApps: 50,
+        supportLevel: "standard",
+    },
+    [SubscriptionTier.ENTERPRISE]: {
+        maxSyncsPerMonth: 5000000,
+        maxStorageBytes: 100 * 1024 * 1024 * 1024, // 100 GB
+        maxTeamMembers: null, // unlimited
+        maxApps: 1000,
+        supportLevel: "priority",
+    },
+};
+/**
+ * Check if a user has access to a specific tier
+ */
+export function hasAccessToTier(subscription, requiredTier) {
+    if (subscription.status !== SubscriptionStatus.ACTIVE) {
+        return false;
+    }
+    const tierOrder = [
+        SubscriptionTier.FREE,
+        SubscriptionTier.SOLO,
+        SubscriptionTier.TEAM,
+        SubscriptionTier.ENTERPRISE,
+    ];
+    const currentTierIndex = tierOrder.indexOf(subscription.tier);
+    const requiredTierIndex = tierOrder.indexOf(requiredTier);
+    return currentTierIndex >= requiredTierIndex;
+}
+/**
+ * Check if usage is within tier limits
+ */
+export function checkUsageLimits(subscription, usage) {
+    const violations = [];
+    if (usage.syncCount > subscription.limits.maxSyncsPerMonth) {
+        violations.push(`Sync limit exceeded: ${usage.syncCount}/${subscription.limits.maxSyncsPerMonth}`);
+    }
+    if (usage.storageBytes > subscription.limits.maxStorageBytes) {
+        violations.push(`Storage limit exceeded: ${(usage.storageBytes / 1024 / 1024).toFixed(2)}MB/${(subscription.limits.maxStorageBytes / 1024 / 1024).toFixed(2)}MB`);
+    }
+    if (subscription.limits.maxTeamMembers !== null &&
+        usage.teamMembers > subscription.limits.maxTeamMembers) {
+        violations.push(`Team member limit exceeded: ${usage.teamMembers}/${subscription.limits.maxTeamMembers}`);
+    }
+    if (usage.appCount > subscription.limits.maxApps) {
+        violations.push(`App limit exceeded: ${usage.appCount}/${subscription.limits.maxApps}`);
+    }
+    return {
+        withinLimits: violations.length === 0,
+        violations,
+    };
+}
+/**
+ * Create a free tier subscription
+ */
+export function createFreeSubscription() {
+    return {
+        tier: SubscriptionTier.FREE,
+        status: SubscriptionStatus.ACTIVE,
+        provider: BillingProvider.NONE,
+        startDate: Date.now(),
+        autoRenew: true,
+        limits: TIER_LIMITS[SubscriptionTier.FREE],
+    };
+}
+/**
+ * Create a subscription from GitHub Sponsors tier
+ */
+export function createSponsorSubscription(tierName, monthlyPriceInCents) {
+    let tier = SubscriptionTier.FREE;
+    // Map price to tier (example pricing)
+    if (monthlyPriceInCents >= 5000) { // $50/month
+        tier = SubscriptionTier.ENTERPRISE;
+    }
+    else if (monthlyPriceInCents >= 2000) { // $20/month
+        tier = SubscriptionTier.TEAM;
+    }
+    else if (monthlyPriceInCents >= 500) { // $5/month
+        tier = SubscriptionTier.SOLO;
+    }
+    return {
+        tier,
+        status: SubscriptionStatus.ACTIVE,
+        provider: BillingProvider.SPONSORS,
+        sponsorTierId: tierName,
+        startDate: Date.now(),
+        autoRenew: true,
+        limits: TIER_LIMITS[tier],
+    };
+}
+//# sourceMappingURL=billing.js.map

package/dist/cloud/billing.js.map

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

package/dist/cloud/client.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Cloud Relay Client
+ *
+ * Client for connecting to Praxis Cloud Relay service (Azure-based).
+ */
+import type { CloudRelayConfig, CloudRelayClient } from "./types.js";
+/**
+ * Create a cloud relay client
+ */
+export declare function createCloudRelay(config: CloudRelayConfig): CloudRelayClient;
+/**
+ * Connect to Praxis Cloud Relay
+ *
+ * @param endpoint - Azure Function App endpoint URL
+ * @param options - Additional configuration options
+ * @returns Cloud relay client instance
+ *
+ * @example
+ * ```typescript
+ * import { connectRelay } from "@plures/praxis/cloud";
+ *
+ * const relay = await connectRelay("https://my-app.azurewebsites.net", {
+ *   appId: "my-app",
+ *   authToken: "github-token",
+ *   autoSync: true
+ * });
+ *
+ * // Sync data
+ * await relay.sync({
+ *   type: "delta",
+ *   appId: "my-app",
+ *   clock: {},
+ *   facts: [...],
+ *   timestamp: Date.now()
+ * });
+ * ```
+ */
+export declare function connectRelay(endpoint: string, options?: Omit<CloudRelayConfig, "endpoint">): Promise<CloudRelayClient>;
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/cloud/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAKjB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAiK3E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAwB,GACjE,OAAO,CAAC,gBAAgB,CAAC,CAS3B"}