@robosystems/client 0.2.9 → 0.2.11

package/sdk/sdk.gen.js

@@ -1,12 +1,17 @@
 "use strict";
 // This file is auto-generated by @hey-api/openapi-ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getGraphUsageAnalytics = exports.getGraphMetrics = exports.getBackupStats = exports.restoreBackup = exports.getBackupDownloadUrl = exports.createBackup = exports.listBackups = exports.callMcpTool = exports.listMcpTools = exports.recommendAgent = exports.getAgentMetadata = exports.listAgents = exports.batchProcessQueries = exports.executeSpecificAgent = exports.autoSelectAgent = exports.syncConnection = exports.getConnection = exports.deleteConnection = exports.oauthCallback = exports.initOAuth = exports.createLinkToken = exports.exchangeLinkToken = exports.getConnectionOptions = exports.createConnection = exports.listConnections = exports.getUserLimits = exports.updateUserApiKey = exports.revokeUserApiKey = exports.createUserApiKey = exports.listUserApiKeys = exports.updateUserPassword = exports.updateUser = exports.getCurrentUser = exports.getServiceStatus = exports.getCaptchaConfig = exports.completeSsoAuth = exports.ssoTokenExchange = exports.generateSsoToken = exports.resetPassword = exports.validateResetToken = exports.forgotPassword = exports.checkPasswordStrength = exports.getPasswordPolicy = exports.verifyEmail = exports.resendVerificationEmail = exports.refreshAuthSession = exports.getCurrentAuthUser = exports.logoutUser = exports.loginUser = exports.registerUser = void 0;
-exports.cancelOperation = exports.getOperationStatus = exports.streamOperationEvents = exports.getServiceOfferings = exports.selectGraph = exports.getAvailableGraphTiers = exports.getAvailableExtensions = exports.createGraph = exports.getGraphs = exports.queryTables = exports.ingestTables = exports.updateFileStatus = exports.getFileInfo = exports.deleteFile = exports.getUploadUrl = exports.listTableFiles = exports.listTables = exports.upgradeSubscription = exports.createRepositorySubscription = exports.getGraphSubscription = exports.cancelSubscription = exports.getSubgraphQuota = exports.getSubgraphInfo = exports.deleteSubgraph = exports.createSubgraph = exports.listSubgraphs = exports.getGraphLimits = exports.getDatabaseInfo = exports.getDatabaseHealth = exports.checkStorageLimits = exports.getStorageUsage = exports.checkCreditBalance = exports.listCreditTransactions = exports.getCreditSummary = exports.validateSchema = exports.exportGraphSchema = exports.getGraphSchema = exports.executeCypherQuery = void 0;
+exports.getAgentMetadata = exports.listAgents = exports.batchProcessQueries = exports.executeSpecificAgent = exports.autoSelectAgent = exports.syncConnection = exports.getConnection = exports.deleteConnection = exports.oauthCallback = exports.initOAuth = exports.createLinkToken = exports.exchangeLinkToken = exports.getConnectionOptions = exports.createConnection = exports.listConnections = exports.getOrgUsage = exports.getOrgLimits = exports.updateOrgMemberRole = exports.removeOrgMember = exports.inviteOrgMember = exports.listOrgMembers = exports.listOrgGraphs = exports.updateOrg = exports.getOrg = exports.createOrg = exports.listUserOrgs = exports.updateUserApiKey = exports.revokeUserApiKey = exports.createUserApiKey = exports.listUserApiKeys = exports.updateUserPassword = exports.updateUser = exports.getCurrentUser = exports.getServiceStatus = exports.getCaptchaConfig = exports.completeSsoAuth = exports.ssoTokenExchange = exports.generateSsoToken = exports.resetPassword = exports.validateResetToken = exports.forgotPassword = exports.checkPasswordStrength = exports.getPasswordPolicy = exports.verifyEmail = exports.resendVerificationEmail = exports.refreshAuthSession = exports.getCurrentAuthUser = exports.logoutUser = exports.loginUser = exports.registerUser = void 0;
+exports.updateOrgPaymentMethod = exports.getOrgBillingCustomer = exports.cancelOperation = exports.getOperationStatus = exports.streamOperationEvents = exports.getServiceOfferings = exports.selectGraph = exports.getAvailableGraphTiers = exports.getAvailableExtensions = exports.createGraph = exports.getGraphs = exports.queryTables = exports.ingestTables = exports.updateFileStatus = exports.getFileInfo = exports.deleteFile = exports.getUploadUrl = exports.listTableFiles = exports.listTables = exports.upgradeSubscription = exports.createRepositorySubscription = exports.getGraphSubscription = exports.cancelSubscription = exports.getSubgraphQuota = exports.getSubgraphInfo = exports.deleteSubgraph = exports.createSubgraph = exports.listSubgraphs = exports.getGraphLimits = exports.getDatabaseInfo = exports.getDatabaseHealth = exports.checkStorageLimits = exports.getStorageUsage = exports.checkCreditBalance = exports.listCreditTransactions = exports.getCreditSummary = exports.validateSchema = exports.exportGraphSchema = exports.getGraphSchema = exports.executeCypherQuery = exports.getGraphUsageAnalytics = exports.getGraphMetrics = exports.getBackupStats = exports.restoreBackup = exports.getBackupDownloadUrl = exports.createBackup = exports.listBackups = exports.callMcpTool = exports.listMcpTools = exports.recommendAgent = void 0;
+exports.getCheckoutStatus = exports.createCheckoutSession = exports.getOrgUpcomingInvoice = exports.listOrgInvoices = exports.cancelOrgSubscription = exports.getOrgSubscription = exports.listOrgSubscriptions = void 0;
 const client_gen_1 = require("./client.gen");
 /**
  * Register New User
- * Register a new user account with email and password. Security controls vary by environment: CAPTCHA and email verification are disabled in development for API testing, but required in production.
+ * Register a new user account with email and password.
+ *
+ * **Organization Creation**: RoboSystems is an org-centric platform. When you register, a personal organization is automatically created for you. All resources (graphs, subscriptions, billing) belong to organizations, not individual users. You can later upgrade your personal org to a team or enterprise organization.
+ *
+ * **Security Controls**: CAPTCHA and email verification are disabled in development for API testing, but required in production.
  */
 const registerUser = (options) => {
     return (options.client ?? client_gen_1.client).post({
@@ -387,10 +392,10 @@ const updateUserApiKey = (options) => {
 };
 exports.updateUserApiKey = updateUserApiKey;
 /**
- * Get user limits and usage
- * Retrieve current limits and usage statistics for the authenticated user (simple safety valve for graph creation)
+ * List User's Organizations
+ * Get all organizations the current user belongs to, with their role in each.
  */
-const getUserLimits = (options) => {
+const listUserOrgs = (options) => {
     return (options?.client ?? client_gen_1.client).get({
         security: [
             {
@@ -402,11 +407,240 @@ const getUserLimits = (options) => {
                 type: 'http'
             }
         ],
-        url: '/v1/user/limits',
+        url: '/v1/orgs',
+        ...options
+    });
+};
+exports.listUserOrgs = listUserOrgs;
+/**
+ * Create Organization
+ * Create a new organization. The creating user becomes the owner.
+ */
+const createOrg = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.createOrg = createOrg;
+/**
+ * Get Organization
+ * Get detailed information about an organization.
+ */
+const getOrg = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}',
+        ...options
+    });
+};
+exports.getOrg = getOrg;
+/**
+ * Update Organization
+ * Update organization information. Requires admin or owner role.
+ */
+const updateOrg = (options) => {
+    return (options.client ?? client_gen_1.client).put({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.updateOrg = updateOrg;
+/**
+ * List Organization Graphs
+ * Get all graphs belonging to an organization.
+ */
+const listOrgGraphs = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/graphs',
+        ...options
+    });
+};
+exports.listOrgGraphs = listOrgGraphs;
+/**
+ * List Organization Members
+ * Get all members of an organization with their roles.
+ */
+const listOrgMembers = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/members',
         ...options
     });
 };
-exports.getUserLimits = getUserLimits;
+exports.listOrgMembers = listOrgMembers;
+/**
+ * Invite Member
+ * Invite a user to join the organization. Requires admin or owner role.
+ *
+ * **⚠️ FEATURE NOT READY**: This endpoint is disabled by default (ORG_MEMBER_INVITATIONS_ENABLED=false).
+ * Returns 501 NOT IMPLEMENTED when disabled. See endpoint implementation for TODO list before enabling.
+ */
+const inviteOrgMember = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/members',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.inviteOrgMember = inviteOrgMember;
+/**
+ * Remove Member
+ * Remove a member from the organization. Requires admin or owner role.
+ */
+const removeOrgMember = (options) => {
+    return (options.client ?? client_gen_1.client).delete({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/members/{user_id}',
+        ...options
+    });
+};
+exports.removeOrgMember = removeOrgMember;
+/**
+ * Update Member Role
+ * Update a member's role in the organization. Requires admin or owner role.
+ */
+const updateOrgMemberRole = (options) => {
+    return (options.client ?? client_gen_1.client).put({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/members/{user_id}',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.updateOrgMemberRole = updateOrgMemberRole;
+/**
+ * Get Organization Limits
+ * Get the current limits and quotas for an organization.
+ */
+const getOrgLimits = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/limits',
+        ...options
+    });
+};
+exports.getOrgLimits = getOrgLimits;
+/**
+ * Get Organization Usage
+ * Get detailed usage statistics for an organization aggregated across all graphs.
+ */
+const getOrgUsage = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/orgs/{org_id}/usage',
+        ...options
+    });
+};
+exports.getOrgUsage = getOrgUsage;
 /**
  * List Connections
  * List all data connections in the graph.
@@ -1392,7 +1626,7 @@ const getGraphMetrics = (options) => {
 exports.getGraphMetrics = getGraphMetrics;
 /**
  * Get Graph Usage Analytics
- * Get comprehensive usage analytics tracked by the GraphUsageTracking model.
+ * Get comprehensive usage analytics tracked by the GraphUsage model.
  *
  * Provides temporal usage patterns including:
  * - **Storage Analytics**: GB-hours for billing, breakdown by type (files, tables, graphs, subgraphs)
@@ -3015,9 +3249,15 @@ exports.selectGraph = selectGraph;
  * and shared repository subscriptions. This is the primary endpoint for frontend
  * applications to display subscription options.
  *
+ * **Pricing Model:**
+ * - Graph subscriptions are **per-graph** with infrastructure-based pricing
+ * - Each graph you create has its own monthly subscription
+ * - Organizations can have multiple graphs with different infrastructure tiers
+ * - Credits are allocated per-graph, not shared across organization
+ *
  * Includes:
- * - Graph subscription tiers (standard, enterprise, premium)
- * - Shared repository subscriptions (SEC, industry, economic data)
+ * - Graph infrastructure tiers (kuzu-standard, kuzu-large, kuzu-xlarge) - per-graph pricing
+ * - Shared repository subscriptions (SEC, industry, economic data) - org-level
  * - Operation costs and credit information
  * - Features and capabilities for each tier
  * - Enabled/disabled status for repositories
@@ -3162,3 +3402,265 @@ const cancelOperation = (options) => {
     });
 };
 exports.cancelOperation = cancelOperation;
+/**
+ * Get Organization Customer Info
+ * Get billing customer information for an organization including payment methods on file.
+ *
+ * Returns customer details, payment methods, and whether invoice billing is enabled.
+ *
+ * **Requirements:**
+ * - User must be a member of the organization
+ * - Sensitive payment details are only visible to owners
+ */
+const getOrgBillingCustomer = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/billing/customer/{org_id}',
+        ...options
+    });
+};
+exports.getOrgBillingCustomer = getOrgBillingCustomer;
+/**
+ * Update Organization Default Payment Method
+ * Update the default payment method for the organization.
+ *
+ * This changes which payment method will be used for future subscription charges.
+ *
+ * **Requirements:**
+ * - User must be an OWNER of the organization
+ */
+const updateOrgPaymentMethod = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/billing/customer/{org_id}/payment-method',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.updateOrgPaymentMethod = updateOrgPaymentMethod;
+/**
+ * List Organization Subscriptions
+ * List all active and past subscriptions for an organization.
+ *
+ * Includes both graph and repository subscriptions with their status, pricing, and billing information.
+ *
+ * **Requirements:**
+ * - User must be a member of the organization
+ */
+const listOrgSubscriptions = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/billing/subscriptions/{org_id}',
+        ...options
+    });
+};
+exports.listOrgSubscriptions = listOrgSubscriptions;
+/**
+ * Get Organization Subscription Details
+ * Get detailed information about a specific subscription.
+ *
+ * **Requirements:**
+ * - User must be a member of the organization
+ */
+const getOrgSubscription = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/billing/subscriptions/{org_id}/subscription/{subscription_id}',
+        ...options
+    });
+};
+exports.getOrgSubscription = getOrgSubscription;
+/**
+ * Cancel Organization Subscription
+ * Cancel an organization subscription.
+ *
+ * The subscription will remain active until the end of the current billing period.
+ *
+ * **Requirements:**
+ * - User must be an OWNER of the organization
+ */
+const cancelOrgSubscription = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/billing/subscriptions/{org_id}/subscription/{subscription_id}/cancel',
+        ...options
+    });
+};
+exports.cancelOrgSubscription = cancelOrgSubscription;
+/**
+ * List Organization Invoices
+ * List payment history and invoices for an organization.
+ *
+ * Returns past invoices with payment status, amounts, and line items.
+ *
+ * **Requirements:**
+ * - User must be a member of the organization
+ * - Full invoice details are only visible to owners and admins
+ */
+const listOrgInvoices = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/billing/invoices/{org_id}',
+        ...options
+    });
+};
+exports.listOrgInvoices = listOrgInvoices;
+/**
+ * Get Organization Upcoming Invoice
+ * Get preview of the next invoice for an organization.
+ *
+ * Returns estimated charges for the next billing period.
+ *
+ * **Requirements:**
+ * - User must be a member of the organization
+ * - Full invoice details are only visible to owners and admins
+ */
+const getOrgUpcomingInvoice = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/billing/invoices/{org_id}/upcoming',
+        ...options
+    });
+};
+exports.getOrgUpcomingInvoice = getOrgUpcomingInvoice;
+/**
+ * Create Payment Checkout Session
+ * Create a Stripe checkout session for collecting payment method.
+ *
+ * This endpoint is used when an organization owner needs to add a payment method before
+ * provisioning resources. It creates a pending subscription and redirects
+ * to Stripe Checkout to collect payment details.
+ *
+ * **Flow:**
+ * 1. Owner tries to create a graph but org has no payment method
+ * 2. Frontend calls this endpoint with graph configuration
+ * 3. Backend creates a subscription in PENDING_PAYMENT status for the user's org
+ * 4. Returns Stripe Checkout URL
+ * 5. User completes payment on Stripe
+ * 6. Webhook activates subscription and provisions resource
+ *
+ * **Requirements:**
+ * - User must be an OWNER of their organization
+ * - Enterprise customers (with invoice_billing_enabled) should not call this endpoint.
+ */
+const createCheckoutSession = (options) => {
+    return (options.client ?? client_gen_1.client).post({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/billing/checkout',
+        ...options,
+        headers: {
+            'Content-Type': 'application/json',
+            ...options.headers
+        }
+    });
+};
+exports.createCheckoutSession = createCheckoutSession;
+/**
+ * Get Checkout Session Status
+ * Poll the status of a checkout session.
+ *
+ * Frontend should poll this endpoint after user returns from Stripe Checkout
+ * to determine when the resource is ready.
+ *
+ * **Status Values:**
+ * - `pending_payment`: Waiting for payment to complete
+ * - `provisioning`: Payment confirmed, resource being created
+ * - `completed`: Resource is ready (resource_id will be set)
+ * - `failed`: Something went wrong (error field will be set)
+ *
+ * **When status is 'completed':**
+ * - For graphs: `resource_id` will be the graph_id, and `operation_id` can be used to monitor SSE progress
+ * - For repositories: `resource_id` will be the repository name and access is immediately available
+ */
+const getCheckoutStatus = (options) => {
+    return (options.client ?? client_gen_1.client).get({
+        security: [
+            {
+                name: 'X-API-Key',
+                type: 'apiKey'
+            },
+            {
+                scheme: 'bearer',
+                type: 'http'
+            }
+        ],
+        url: '/v1/billing/checkout/{session_id}/status',
+        ...options
+    });
+};
+exports.getCheckoutStatus = getCheckoutStatus;