@robosystems/client 0.2.14 → 0.2.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (47) hide show
  1. package/extensions/FileClient.d.ts +57 -0
  2. package/extensions/{TableIngestClient.js → FileClient.js} +59 -80
  3. package/extensions/{TableIngestClient.ts → FileClient.ts} +71 -125
  4. package/extensions/MaterializationClient.d.ts +51 -0
  5. package/extensions/MaterializationClient.js +107 -0
  6. package/extensions/MaterializationClient.ts +163 -0
  7. package/extensions/TableClient.d.ts +38 -0
  8. package/extensions/TableClient.js +92 -0
  9. package/extensions/TableClient.ts +132 -0
  10. package/extensions/hooks.d.ts +9 -11
  11. package/extensions/hooks.js +21 -56
  12. package/extensions/hooks.ts +30 -79
  13. package/extensions/index.d.ts +14 -4
  14. package/extensions/index.js +32 -5
  15. package/extensions/index.test.ts +10 -2
  16. package/extensions/index.ts +46 -5
  17. package/package.json +1 -1
  18. package/sdk/sdk.gen.d.ts +324 -244
  19. package/sdk/sdk.gen.js +410 -274
  20. package/sdk/sdk.gen.ts +404 -268
  21. package/sdk/types.gen.d.ts +697 -239
  22. package/sdk/types.gen.ts +736 -253
  23. package/sdk-extensions/FileClient.d.ts +57 -0
  24. package/sdk-extensions/{TableIngestClient.js → FileClient.js} +59 -80
  25. package/sdk-extensions/{TableIngestClient.ts → FileClient.ts} +71 -125
  26. package/sdk-extensions/MaterializationClient.d.ts +51 -0
  27. package/sdk-extensions/MaterializationClient.js +107 -0
  28. package/sdk-extensions/MaterializationClient.ts +163 -0
  29. package/sdk-extensions/TableClient.d.ts +38 -0
  30. package/sdk-extensions/TableClient.js +92 -0
  31. package/sdk-extensions/TableClient.ts +132 -0
  32. package/sdk-extensions/hooks.d.ts +9 -11
  33. package/sdk-extensions/hooks.js +21 -56
  34. package/sdk-extensions/hooks.ts +30 -79
  35. package/sdk-extensions/index.d.ts +14 -4
  36. package/sdk-extensions/index.js +32 -5
  37. package/sdk-extensions/index.test.ts +10 -2
  38. package/sdk-extensions/index.ts +46 -5
  39. package/sdk.gen.d.ts +324 -244
  40. package/sdk.gen.js +410 -274
  41. package/sdk.gen.ts +404 -268
  42. package/types.gen.d.ts +697 -239
  43. package/types.gen.ts +736 -253
  44. package/extensions/TableIngestClient.d.ts +0 -75
  45. package/extensions/TableIngestClient.test.ts +0 -304
  46. package/sdk-extensions/TableIngestClient.d.ts +0 -75
  47. package/sdk-extensions/TableIngestClient.test.ts +0 -304
@@ -748,71 +748,6 @@ export type BillingCustomer = {
748
748
  */
749
749
  created_at: string;
750
750
  };
751
- /**
752
- * BulkIngestRequest
753
- */
754
- export type BulkIngestRequest = {
755
- /**
756
- * Ignore Errors
757
- * Continue ingestion on row errors
758
- */
759
- ignore_errors?: boolean;
760
- /**
761
- * Rebuild
762
- * Rebuild graph database from scratch before ingestion. Safe operation - staged data is the source of truth, graph can always be regenerated.
763
- */
764
- rebuild?: boolean;
765
- };
766
- /**
767
- * BulkIngestResponse
768
- */
769
- export type BulkIngestResponse = {
770
- /**
771
- * Status
772
- * Overall ingestion status
773
- */
774
- status: string;
775
- /**
776
- * Graph Id
777
- * Graph database identifier
778
- */
779
- graph_id: string;
780
- /**
781
- * Total Tables
782
- * Total number of tables processed
783
- */
784
- total_tables: number;
785
- /**
786
- * Successful Tables
787
- * Number of successfully ingested tables
788
- */
789
- successful_tables: number;
790
- /**
791
- * Failed Tables
792
- * Number of failed table ingestions
793
- */
794
- failed_tables: number;
795
- /**
796
- * Skipped Tables
797
- * Number of skipped tables (no files)
798
- */
799
- skipped_tables: number;
800
- /**
801
- * Total Rows Ingested
802
- * Total rows ingested across all tables
803
- */
804
- total_rows_ingested: number;
805
- /**
806
- * Total Execution Time Ms
807
- * Total execution time in milliseconds
808
- */
809
- total_execution_time_ms: number;
810
- /**
811
- * Results
812
- * Per-table ingestion results
813
- */
814
- results: Array<TableIngestResult>;
815
- };
816
751
  /**
817
752
  * CheckoutResponse
818
753
  * Response from checkout session creation.
@@ -1214,6 +1149,39 @@ export type CreateSubgraphRequest = {
1214
1149
  metadata?: {
1215
1150
  [key: string]: unknown;
1216
1151
  } | null;
1152
+ /**
1153
+ * Fork Parent
1154
+ * If true, copy all data from parent graph to create a 'fork'
1155
+ */
1156
+ fork_parent?: boolean;
1157
+ };
1158
+ /**
1159
+ * CreateViewRequest
1160
+ */
1161
+ export type CreateViewRequest = {
1162
+ /**
1163
+ * Name
1164
+ * Optional name for the view
1165
+ */
1166
+ name?: string | null;
1167
+ /**
1168
+ * Data source configuration
1169
+ */
1170
+ source: ViewSource;
1171
+ /**
1172
+ * View configuration
1173
+ */
1174
+ view_config?: ViewConfig;
1175
+ /**
1176
+ * Presentation Formats
1177
+ * Presentation formats to generate
1178
+ */
1179
+ presentation_formats?: Array<string>;
1180
+ /**
1181
+ * Mapping Structure Id
1182
+ * Optional mapping structure ID to aggregate Chart of Accounts elements into reporting taxonomy elements
1183
+ */
1184
+ mapping_structure_id?: string | null;
1217
1185
  };
1218
1186
  /**
1219
1187
  * CreditLimits
@@ -1557,6 +1525,21 @@ export type DeleteFileResponse = {
1557
1525
  * Operation message
1558
1526
  */
1559
1527
  message: string;
1528
+ /**
1529
+ * Cascade Deleted
1530
+ * Whether cascade deletion was performed
1531
+ */
1532
+ cascade_deleted?: boolean;
1533
+ /**
1534
+ * Tables Affected
1535
+ * Tables from which file data was deleted (if cascade=true)
1536
+ */
1537
+ tables_affected?: Array<string> | null;
1538
+ /**
1539
+ * Graph Marked Stale
1540
+ * Whether graph was marked as stale
1541
+ */
1542
+ graph_marked_stale?: boolean;
1560
1543
  };
1561
1544
  /**
1562
1545
  * DeleteSubgraphRequest
@@ -1699,6 +1682,23 @@ export type EnhancedCreditTransactionResponse = {
1699
1682
  */
1700
1683
  user_id?: string | null;
1701
1684
  };
1685
+ /**
1686
+ * EnhancedFileStatusLayers
1687
+ */
1688
+ export type EnhancedFileStatusLayers = {
1689
+ /**
1690
+ * S3 layer status (immutable source)
1691
+ */
1692
+ s3: FileLayerStatus;
1693
+ /**
1694
+ * DuckDB layer status (mutable staging)
1695
+ */
1696
+ duckdb: FileLayerStatus;
1697
+ /**
1698
+ * Graph layer status (immutable materialized view)
1699
+ */
1700
+ graph: FileLayerStatus;
1701
+ };
1702
1702
  /**
1703
1703
  * ErrorResponse
1704
1704
  * Standard error response format used across all API endpoints.
@@ -1751,6 +1751,39 @@ export type ExchangeTokenRequest = {
1751
1751
  [key: string]: unknown;
1752
1752
  } | null;
1753
1753
  };
1754
+ /**
1755
+ * FactDetail
1756
+ */
1757
+ export type FactDetail = {
1758
+ /**
1759
+ * Fact Id
1760
+ */
1761
+ fact_id: string;
1762
+ /**
1763
+ * Element Uri
1764
+ */
1765
+ element_uri: string;
1766
+ /**
1767
+ * Element Name
1768
+ */
1769
+ element_name: string;
1770
+ /**
1771
+ * Numeric Value
1772
+ */
1773
+ numeric_value: number;
1774
+ /**
1775
+ * Unit
1776
+ */
1777
+ unit: string;
1778
+ /**
1779
+ * Period Start
1780
+ */
1781
+ period_start: string;
1782
+ /**
1783
+ * Period End
1784
+ */
1785
+ period_end: string;
1786
+ };
1754
1787
  /**
1755
1788
  * FileInfo
1756
1789
  */
@@ -1806,6 +1839,31 @@ export type FileInfo = {
1806
1839
  */
1807
1840
  s3_key: string;
1808
1841
  };
1842
+ /**
1843
+ * FileLayerStatus
1844
+ */
1845
+ export type FileLayerStatus = {
1846
+ /**
1847
+ * Status
1848
+ * Layer status
1849
+ */
1850
+ status: string;
1851
+ /**
1852
+ * Timestamp
1853
+ * Status timestamp
1854
+ */
1855
+ timestamp?: string | null;
1856
+ /**
1857
+ * Row Count
1858
+ * Row count (if available)
1859
+ */
1860
+ row_count?: number | null;
1861
+ /**
1862
+ * Size Bytes
1863
+ * Size in bytes (S3 layer only)
1864
+ */
1865
+ size_bytes?: number | null;
1866
+ };
1809
1867
  /**
1810
1868
  * FileStatusUpdate
1811
1869
  */
@@ -1815,6 +1873,11 @@ export type FileStatusUpdate = {
1815
1873
  * File status: 'uploaded' (ready for ingest), 'disabled' (exclude from ingest), 'archived' (soft deleted)
1816
1874
  */
1817
1875
  status: string;
1876
+ /**
1877
+ * Ingest To Graph
1878
+ * Auto-ingest to graph after DuckDB staging. Default=false (batch mode). Set to true for real-time incremental updates.
1879
+ */
1880
+ ingest_to_graph?: boolean;
1818
1881
  };
1819
1882
  /**
1820
1883
  * FileUploadRequest
@@ -1830,6 +1893,11 @@ export type FileUploadRequest = {
1830
1893
  * File MIME type
1831
1894
  */
1832
1895
  content_type?: string;
1896
+ /**
1897
+ * Table Name
1898
+ * Table name to associate file with (required for first-class /files endpoint)
1899
+ */
1900
+ table_name?: string | null;
1833
1901
  };
1834
1902
  /**
1835
1903
  * FileUploadResponse
@@ -1936,6 +2004,10 @@ export type GetFileInfoResponse = {
1936
2004
  * S3 object key
1937
2005
  */
1938
2006
  s3_key: string;
2007
+ /**
2008
+ * Multi-layer pipeline status (S3 → DuckDB → Graph). Shows status, timestamps, and row counts for each layer independently.
2009
+ */
2010
+ layers?: EnhancedFileStatusLayers | null;
1939
2011
  };
1940
2012
  /**
1941
2013
  * GraphInfo
@@ -2838,9 +2910,9 @@ export type ListTableFilesResponse = {
2838
2910
  graph_id: string;
2839
2911
  /**
2840
2912
  * Table Name
2841
- * Table name
2913
+ * Table name (null if listing all files in graph)
2842
2914
  */
2843
- table_name: string;
2915
+ table_name?: string | null;
2844
2916
  /**
2845
2917
  * Files
2846
2918
  * List of files in the table
@@ -2904,6 +2976,116 @@ export type McpToolsResponse = {
2904
2976
  [key: string]: unknown;
2905
2977
  }>;
2906
2978
  };
2979
+ /**
2980
+ * MaterializeRequest
2981
+ */
2982
+ export type MaterializeRequest = {
2983
+ /**
2984
+ * Force
2985
+ * Force materialization even if graph is not stale
2986
+ */
2987
+ force?: boolean;
2988
+ /**
2989
+ * Rebuild
2990
+ * Delete and recreate graph database before materialization
2991
+ */
2992
+ rebuild?: boolean;
2993
+ /**
2994
+ * Ignore Errors
2995
+ * Continue ingestion on row errors
2996
+ */
2997
+ ignore_errors?: boolean;
2998
+ };
2999
+ /**
3000
+ * MaterializeResponse
3001
+ */
3002
+ export type MaterializeResponse = {
3003
+ /**
3004
+ * Status
3005
+ * Materialization status
3006
+ */
3007
+ status: string;
3008
+ /**
3009
+ * Graph Id
3010
+ * Graph database identifier
3011
+ */
3012
+ graph_id: string;
3013
+ /**
3014
+ * Was Stale
3015
+ * Whether graph was stale before materialization
3016
+ */
3017
+ was_stale: boolean;
3018
+ /**
3019
+ * Stale Reason
3020
+ * Reason graph was stale
3021
+ */
3022
+ stale_reason?: string | null;
3023
+ /**
3024
+ * Tables Materialized
3025
+ * List of tables successfully materialized
3026
+ */
3027
+ tables_materialized: Array<string>;
3028
+ /**
3029
+ * Total Rows
3030
+ * Total rows materialized across all tables
3031
+ */
3032
+ total_rows: number;
3033
+ /**
3034
+ * Execution Time Ms
3035
+ * Total materialization time
3036
+ */
3037
+ execution_time_ms: number;
3038
+ /**
3039
+ * Message
3040
+ * Human-readable status message
3041
+ */
3042
+ message: string;
3043
+ };
3044
+ /**
3045
+ * MaterializeStatusResponse
3046
+ */
3047
+ export type MaterializeStatusResponse = {
3048
+ /**
3049
+ * Graph Id
3050
+ * Graph database identifier
3051
+ */
3052
+ graph_id: string;
3053
+ /**
3054
+ * Is Stale
3055
+ * Whether graph is currently stale
3056
+ */
3057
+ is_stale: boolean;
3058
+ /**
3059
+ * Stale Reason
3060
+ * Reason for staleness if applicable
3061
+ */
3062
+ stale_reason?: string | null;
3063
+ /**
3064
+ * Stale Since
3065
+ * When graph became stale (ISO timestamp)
3066
+ */
3067
+ stale_since?: string | null;
3068
+ /**
3069
+ * Last Materialized At
3070
+ * When graph was last materialized (ISO timestamp)
3071
+ */
3072
+ last_materialized_at?: string | null;
3073
+ /**
3074
+ * Materialization Count
3075
+ * Total number of materializations performed
3076
+ */
3077
+ materialization_count?: number;
3078
+ /**
3079
+ * Hours Since Materialization
3080
+ * Hours since last materialization
3081
+ */
3082
+ hours_since_materialization?: number | null;
3083
+ /**
3084
+ * Message
3085
+ * Human-readable status summary
3086
+ */
3087
+ message: string;
3088
+ };
2907
3089
  /**
2908
3090
  * OAuthCallbackRequest
2909
3091
  * OAuth callback parameters.
@@ -3781,6 +3963,105 @@ export type SsoTokenResponse = {
3781
3963
  */
3782
3964
  apps: Array<string>;
3783
3965
  };
3966
+ /**
3967
+ * SaveViewRequest
3968
+ */
3969
+ export type SaveViewRequest = {
3970
+ /**
3971
+ * Report Id
3972
+ * Existing report ID to update (if provided, deletes existing facts/structures and creates new ones)
3973
+ */
3974
+ report_id?: string | null;
3975
+ /**
3976
+ * Report Type
3977
+ * Type of report (e.g., 'Annual Report', 'Quarterly Report', '10-K')
3978
+ */
3979
+ report_type: string;
3980
+ /**
3981
+ * Period Start
3982
+ * Period start date (YYYY-MM-DD)
3983
+ */
3984
+ period_start: string;
3985
+ /**
3986
+ * Period End
3987
+ * Period end date (YYYY-MM-DD)
3988
+ */
3989
+ period_end: string;
3990
+ /**
3991
+ * Entity Id
3992
+ * Entity identifier (defaults to primary entity)
3993
+ */
3994
+ entity_id?: string | null;
3995
+ /**
3996
+ * Include Presentation
3997
+ * Create presentation structures
3998
+ */
3999
+ include_presentation?: boolean;
4000
+ /**
4001
+ * Include Calculation
4002
+ * Create calculation structures
4003
+ */
4004
+ include_calculation?: boolean;
4005
+ };
4006
+ /**
4007
+ * SaveViewResponse
4008
+ */
4009
+ export type SaveViewResponse = {
4010
+ /**
4011
+ * Report Id
4012
+ * Unique report identifier (used as parquet export prefix)
4013
+ */
4014
+ report_id: string;
4015
+ /**
4016
+ * Report Type
4017
+ */
4018
+ report_type: string;
4019
+ /**
4020
+ * Entity Id
4021
+ */
4022
+ entity_id: string;
4023
+ /**
4024
+ * Entity Name
4025
+ */
4026
+ entity_name: string;
4027
+ /**
4028
+ * Period Start
4029
+ */
4030
+ period_start: string;
4031
+ /**
4032
+ * Period End
4033
+ */
4034
+ period_end: string;
4035
+ /**
4036
+ * Fact Count
4037
+ */
4038
+ fact_count: number;
4039
+ /**
4040
+ * Presentation Count
4041
+ */
4042
+ presentation_count: number;
4043
+ /**
4044
+ * Calculation Count
4045
+ */
4046
+ calculation_count: number;
4047
+ /**
4048
+ * Facts
4049
+ */
4050
+ facts: Array<FactDetail>;
4051
+ /**
4052
+ * Structures
4053
+ */
4054
+ structures: Array<StructureDetail>;
4055
+ /**
4056
+ * Created At
4057
+ */
4058
+ created_at: string;
4059
+ /**
4060
+ * Parquet Export Prefix
4061
+ * Prefix for parquet file exports
4062
+ */
4063
+ parquet_export_prefix: string;
4064
+ };
3784
4065
  /**
3785
4066
  * SchemaExportResponse
3786
4067
  * Response model for schema export.
@@ -4103,17 +4384,38 @@ export type StorageSummary = {
4103
4384
  measurement_count: number;
4104
4385
  };
4105
4386
  /**
4106
- * SubgraphQuotaResponse
4107
- * Response model for subgraph quota information.
4387
+ * StructureDetail
4108
4388
  */
4109
- export type SubgraphQuotaResponse = {
4389
+ export type StructureDetail = {
4110
4390
  /**
4111
- * Parent Graph Id
4112
- * Parent graph identifier
4391
+ * Structure Id
4113
4392
  */
4114
- parent_graph_id: string;
4393
+ structure_id: string;
4115
4394
  /**
4116
- * Tier
4395
+ * Structure Type
4396
+ */
4397
+ structure_type: string;
4398
+ /**
4399
+ * Name
4400
+ */
4401
+ name: string;
4402
+ /**
4403
+ * Element Count
4404
+ */
4405
+ element_count: number;
4406
+ };
4407
+ /**
4408
+ * SubgraphQuotaResponse
4409
+ * Response model for subgraph quota information.
4410
+ */
4411
+ export type SubgraphQuotaResponse = {
4412
+ /**
4413
+ * Parent Graph Id
4414
+ * Parent graph identifier
4415
+ */
4416
+ parent_graph_id: string;
4417
+ /**
4418
+ * Tier
4117
4419
  * Graph tier
4118
4420
  */
4119
4421
  tier: string;
@@ -4346,36 +4648,6 @@ export type TableInfo = {
4346
4648
  */
4347
4649
  s3_location?: string | null;
4348
4650
  };
4349
- /**
4350
- * TableIngestResult
4351
- */
4352
- export type TableIngestResult = {
4353
- /**
4354
- * Table Name
4355
- * Table name
4356
- */
4357
- table_name: string;
4358
- /**
4359
- * Status
4360
- * Ingestion status (success/failed/skipped)
4361
- */
4362
- status: string;
4363
- /**
4364
- * Rows Ingested
4365
- * Number of rows ingested
4366
- */
4367
- rows_ingested?: number;
4368
- /**
4369
- * Execution Time Ms
4370
- * Ingestion time in milliseconds
4371
- */
4372
- execution_time_ms?: number;
4373
- /**
4374
- * Error
4375
- * Error message if failed
4376
- */
4377
- error?: string | null;
4378
- };
4379
4651
  /**
4380
4652
  * TableListResponse
4381
4653
  */
@@ -4654,6 +4926,118 @@ export type ValidationError = {
4654
4926
  */
4655
4927
  type: string;
4656
4928
  };
4929
+ /**
4930
+ * ViewAxisConfig
4931
+ */
4932
+ export type ViewAxisConfig = {
4933
+ /**
4934
+ * Type
4935
+ * Axis type: 'element', 'period', 'dimension', 'entity'
4936
+ */
4937
+ type: string;
4938
+ /**
4939
+ * Dimension Axis
4940
+ * Dimension axis name for dimension-type axes
4941
+ */
4942
+ dimension_axis?: string | null;
4943
+ /**
4944
+ * Include Null Dimension
4945
+ * Include facts where this dimension is NULL (default: false)
4946
+ */
4947
+ include_null_dimension?: boolean;
4948
+ /**
4949
+ * Selected Members
4950
+ * Specific members to include (e.g., ['2024-12-31', '2023-12-31'])
4951
+ */
4952
+ selected_members?: Array<string> | null;
4953
+ /**
4954
+ * Member Order
4955
+ * Explicit ordering of members (overrides default sort)
4956
+ */
4957
+ member_order?: Array<string> | null;
4958
+ /**
4959
+ * Member Labels
4960
+ * Custom labels for members (e.g., {'2024-12-31': 'Current Year'})
4961
+ */
4962
+ member_labels?: {
4963
+ [key: string]: string;
4964
+ } | null;
4965
+ /**
4966
+ * Element Order
4967
+ * Element ordering for hierarchy display (e.g., ['us-gaap:Assets', 'us-gaap:Cash', ...])
4968
+ */
4969
+ element_order?: Array<string> | null;
4970
+ /**
4971
+ * Element Labels
4972
+ * Custom labels for elements (e.g., {'us-gaap:Cash': 'Cash and Cash Equivalents'})
4973
+ */
4974
+ element_labels?: {
4975
+ [key: string]: string;
4976
+ } | null;
4977
+ };
4978
+ /**
4979
+ * ViewConfig
4980
+ */
4981
+ export type ViewConfig = {
4982
+ /**
4983
+ * Rows
4984
+ * Row axis configuration
4985
+ */
4986
+ rows?: Array<ViewAxisConfig>;
4987
+ /**
4988
+ * Columns
4989
+ * Column axis configuration
4990
+ */
4991
+ columns?: Array<ViewAxisConfig>;
4992
+ /**
4993
+ * Values
4994
+ * Field to use for values (default: numeric_value)
4995
+ */
4996
+ values?: string;
4997
+ /**
4998
+ * Aggregation Function
4999
+ * Aggregation function: sum, average, count
5000
+ */
5001
+ aggregation_function?: string;
5002
+ /**
5003
+ * Fill Value
5004
+ * Value to use for missing data
5005
+ */
5006
+ fill_value?: number;
5007
+ };
5008
+ /**
5009
+ * ViewSource
5010
+ */
5011
+ export type ViewSource = {
5012
+ /**
5013
+ * Type of data source
5014
+ */
5015
+ type: ViewSourceType;
5016
+ /**
5017
+ * Period Start
5018
+ * Start date for transaction aggregation (YYYY-MM-DD)
5019
+ */
5020
+ period_start?: string | null;
5021
+ /**
5022
+ * Period End
5023
+ * End date for transaction aggregation (YYYY-MM-DD)
5024
+ */
5025
+ period_end?: string | null;
5026
+ /**
5027
+ * Fact Set Id
5028
+ * FactSet ID for existing facts mode
5029
+ */
5030
+ fact_set_id?: string | null;
5031
+ /**
5032
+ * Entity Id
5033
+ * Filter by entity (optional)
5034
+ */
5035
+ entity_id?: string | null;
5036
+ };
5037
+ /**
5038
+ * ViewSourceType
5039
+ */
5040
+ export type ViewSourceType = 'transactions' | 'fact_set';
4657
5041
  export type RegisterUserData = {
4658
5042
  body: RegisterRequest;
4659
5043
  path?: never;
@@ -7096,7 +7480,7 @@ export type CreateSubgraphResponses = {
7096
7480
  /**
7097
7481
  * Successful Response
7098
7482
  */
7099
- 201: SubgraphResponse;
7483
+ 200: SubgraphResponse;
7100
7484
  };
7101
7485
  export type CreateSubgraphResponse = CreateSubgraphResponses[keyof CreateSubgraphResponses];
7102
7486
  export type DeleteSubgraphData = {
@@ -7379,35 +7763,41 @@ export type ListTablesResponses = {
7379
7763
  200: TableListResponse;
7380
7764
  };
7381
7765
  export type ListTablesResponse = ListTablesResponses[keyof ListTablesResponses];
7382
- export type ListTableFilesData = {
7383
- body?: never;
7766
+ export type QueryTablesData = {
7767
+ /**
7768
+ * SQL query request
7769
+ */
7770
+ body: TableQueryRequest;
7384
7771
  path: {
7385
7772
  /**
7386
7773
  * Graph Id
7387
7774
  */
7388
7775
  graph_id: string;
7389
- /**
7390
- * Table Name
7391
- * Table name
7392
- */
7393
- table_name: string;
7394
7776
  };
7395
7777
  query?: never;
7396
- url: '/v1/graphs/{graph_id}/tables/{table_name}/files';
7778
+ url: '/v1/graphs/{graph_id}/tables/query';
7397
7779
  };
7398
- export type ListTableFilesErrors = {
7780
+ export type QueryTablesErrors = {
7781
+ /**
7782
+ * Invalid SQL query syntax or execution error
7783
+ */
7784
+ 400: ErrorResponse;
7399
7785
  /**
7400
7786
  * Not authenticated
7401
7787
  */
7402
7788
  401: unknown;
7403
7789
  /**
7404
- * Access denied - insufficient permissions for this graph
7790
+ * Access denied - shared repositories or insufficient permissions
7405
7791
  */
7406
7792
  403: ErrorResponse;
7407
7793
  /**
7408
- * Graph or table not found
7794
+ * Graph not found
7409
7795
  */
7410
7796
  404: ErrorResponse;
7797
+ /**
7798
+ * Query timeout exceeded
7799
+ */
7800
+ 408: unknown;
7411
7801
  /**
7412
7802
  * Validation Error
7413
7803
  */
@@ -7417,44 +7807,81 @@ export type ListTableFilesErrors = {
7417
7807
  */
7418
7808
  500: unknown;
7419
7809
  };
7420
- export type ListTableFilesError = ListTableFilesErrors[keyof ListTableFilesErrors];
7421
- export type ListTableFilesResponses = {
7810
+ export type QueryTablesError = QueryTablesErrors[keyof QueryTablesErrors];
7811
+ export type QueryTablesResponses = {
7422
7812
  /**
7423
- * Files retrieved successfully with full metadata
7813
+ * Query executed successfully
7424
7814
  */
7425
- 200: ListTableFilesResponse;
7815
+ 200: TableQueryResponse;
7426
7816
  };
7427
- export type ListTableFilesResponse2 = ListTableFilesResponses[keyof ListTableFilesResponses];
7428
- export type GetUploadUrlData = {
7429
- /**
7430
- * Upload request
7431
- */
7432
- body: FileUploadRequest;
7817
+ export type QueryTablesResponse = QueryTablesResponses[keyof QueryTablesResponses];
7818
+ export type CreateViewData = {
7819
+ body: CreateViewRequest;
7433
7820
  path: {
7434
7821
  /**
7435
7822
  * Graph Id
7436
7823
  */
7437
7824
  graph_id: string;
7825
+ };
7826
+ query?: never;
7827
+ url: '/v1/graphs/{graph_id}/views';
7828
+ };
7829
+ export type CreateViewErrors = {
7830
+ /**
7831
+ * Validation Error
7832
+ */
7833
+ 422: HttpValidationError;
7834
+ };
7835
+ export type CreateViewError = CreateViewErrors[keyof CreateViewErrors];
7836
+ export type CreateViewResponses = {
7837
+ /**
7838
+ * Successful Response
7839
+ */
7840
+ 200: unknown;
7841
+ };
7842
+ export type SaveViewData = {
7843
+ body: SaveViewRequest;
7844
+ path: {
7438
7845
  /**
7439
- * Table Name
7440
- * Table name
7846
+ * Graph Id
7441
7847
  */
7442
- table_name: string;
7848
+ graph_id: string;
7443
7849
  };
7444
7850
  query?: never;
7445
- url: '/v1/graphs/{graph_id}/tables/{table_name}/files';
7851
+ url: '/v1/graphs/{graph_id}/views/save';
7446
7852
  };
7447
- export type GetUploadUrlErrors = {
7853
+ export type SaveViewErrors = {
7448
7854
  /**
7449
- * Invalid file format, name, or extension mismatch
7855
+ * Validation Error
7450
7856
  */
7451
- 400: ErrorResponse;
7857
+ 422: HttpValidationError;
7858
+ };
7859
+ export type SaveViewError = SaveViewErrors[keyof SaveViewErrors];
7860
+ export type SaveViewResponses = {
7861
+ /**
7862
+ * Successful Response
7863
+ */
7864
+ 200: SaveViewResponse;
7865
+ };
7866
+ export type SaveViewResponse2 = SaveViewResponses[keyof SaveViewResponses];
7867
+ export type GetMaterializationStatusData = {
7868
+ body?: never;
7869
+ path: {
7870
+ /**
7871
+ * Graph Id
7872
+ */
7873
+ graph_id: string;
7874
+ };
7875
+ query?: never;
7876
+ url: '/v1/graphs/{graph_id}/materialize/status';
7877
+ };
7878
+ export type GetMaterializationStatusErrors = {
7452
7879
  /**
7453
7880
  * Not authenticated
7454
7881
  */
7455
7882
  401: unknown;
7456
7883
  /**
7457
- * Access denied - shared repositories or insufficient permissions
7884
+ * Access denied - insufficient permissions
7458
7885
  */
7459
7886
  403: ErrorResponse;
7460
7887
  /**
@@ -7465,36 +7892,31 @@ export type GetUploadUrlErrors = {
7465
7892
  * Validation Error
7466
7893
  */
7467
7894
  422: HttpValidationError;
7468
- /**
7469
- * Internal server error
7470
- */
7471
- 500: unknown;
7472
7895
  };
7473
- export type GetUploadUrlError = GetUploadUrlErrors[keyof GetUploadUrlErrors];
7474
- export type GetUploadUrlResponses = {
7896
+ export type GetMaterializationStatusError = GetMaterializationStatusErrors[keyof GetMaterializationStatusErrors];
7897
+ export type GetMaterializationStatusResponses = {
7475
7898
  /**
7476
- * Upload URL generated successfully
7899
+ * Materialization status retrieved successfully
7477
7900
  */
7478
- 200: FileUploadResponse;
7901
+ 200: MaterializeStatusResponse;
7479
7902
  };
7480
- export type GetUploadUrlResponse = GetUploadUrlResponses[keyof GetUploadUrlResponses];
7481
- export type DeleteFileData = {
7482
- body?: never;
7903
+ export type GetMaterializationStatusResponse = GetMaterializationStatusResponses[keyof GetMaterializationStatusResponses];
7904
+ export type MaterializeGraphData = {
7905
+ body: MaterializeRequest;
7483
7906
  path: {
7484
7907
  /**
7485
7908
  * Graph Id
7486
7909
  */
7487
7910
  graph_id: string;
7488
- /**
7489
- * File Id
7490
- * File ID
7491
- */
7492
- file_id: string;
7493
7911
  };
7494
7912
  query?: never;
7495
- url: '/v1/graphs/{graph_id}/tables/files/{file_id}';
7913
+ url: '/v1/graphs/{graph_id}/materialize';
7496
7914
  };
7497
- export type DeleteFileErrors = {
7915
+ export type MaterializeGraphErrors = {
7916
+ /**
7917
+ * Graph not stale and force=false
7918
+ */
7919
+ 400: ErrorResponse;
7498
7920
  /**
7499
7921
  * Not authenticated
7500
7922
  */
@@ -7504,9 +7926,13 @@ export type DeleteFileErrors = {
7504
7926
  */
7505
7927
  403: ErrorResponse;
7506
7928
  /**
7507
- * File not found in graph
7929
+ * Graph not found
7508
7930
  */
7509
7931
  404: ErrorResponse;
7932
+ /**
7933
+ * Conflict - another materialization is already in progress for this graph
7934
+ */
7935
+ 409: ErrorResponse;
7510
7936
  /**
7511
7937
  * Validation Error
7512
7938
  */
@@ -7516,41 +7942,47 @@ export type DeleteFileErrors = {
7516
7942
  */
7517
7943
  500: unknown;
7518
7944
  };
7519
- export type DeleteFileError = DeleteFileErrors[keyof DeleteFileErrors];
7520
- export type DeleteFileResponses = {
7945
+ export type MaterializeGraphError = MaterializeGraphErrors[keyof MaterializeGraphErrors];
7946
+ export type MaterializeGraphResponses = {
7521
7947
  /**
7522
- * File deleted successfully
7948
+ * Graph materialized successfully
7523
7949
  */
7524
- 200: DeleteFileResponse;
7950
+ 200: MaterializeResponse;
7525
7951
  };
7526
- export type DeleteFileResponse2 = DeleteFileResponses[keyof DeleteFileResponses];
7527
- export type GetFileInfoData = {
7952
+ export type MaterializeGraphResponse = MaterializeGraphResponses[keyof MaterializeGraphResponses];
7953
+ export type ListFilesData = {
7528
7954
  body?: never;
7529
7955
  path: {
7530
7956
  /**
7531
7957
  * Graph Id
7532
7958
  */
7533
7959
  graph_id: string;
7960
+ };
7961
+ query?: {
7534
7962
  /**
7535
- * File Id
7536
- * File ID
7963
+ * Table Name
7964
+ * Filter by table name (optional)
7537
7965
  */
7538
- file_id: string;
7966
+ table_name?: string | null;
7967
+ /**
7968
+ * Status
7969
+ * Filter by upload status (optional)
7970
+ */
7971
+ status?: string | null;
7539
7972
  };
7540
- query?: never;
7541
- url: '/v1/graphs/{graph_id}/tables/files/{file_id}';
7973
+ url: '/v1/graphs/{graph_id}/files';
7542
7974
  };
7543
- export type GetFileInfoErrors = {
7975
+ export type ListFilesErrors = {
7544
7976
  /**
7545
7977
  * Not authenticated
7546
7978
  */
7547
7979
  401: unknown;
7548
7980
  /**
7549
- * Access denied - insufficient permissions for this graph
7981
+ * Access denied - insufficient permissions
7550
7982
  */
7551
7983
  403: ErrorResponse;
7552
7984
  /**
7553
- * File not found in graph
7985
+ * Graph not found
7554
7986
  */
7555
7987
  404: ErrorResponse;
7556
7988
  /**
@@ -7558,36 +7990,31 @@ export type GetFileInfoErrors = {
7558
7990
  */
7559
7991
  422: HttpValidationError;
7560
7992
  };
7561
- export type GetFileInfoError = GetFileInfoErrors[keyof GetFileInfoErrors];
7562
- export type GetFileInfoResponses = {
7993
+ export type ListFilesError = ListFilesErrors[keyof ListFilesErrors];
7994
+ export type ListFilesResponses = {
7563
7995
  /**
7564
- * File information retrieved successfully
7996
+ * Files retrieved successfully
7565
7997
  */
7566
- 200: GetFileInfoResponse;
7998
+ 200: ListTableFilesResponse;
7567
7999
  };
7568
- export type GetFileInfoResponse2 = GetFileInfoResponses[keyof GetFileInfoResponses];
7569
- export type UpdateFileStatusData = {
8000
+ export type ListFilesResponse = ListFilesResponses[keyof ListFilesResponses];
8001
+ export type CreateFileUploadData = {
7570
8002
  /**
7571
- * Status update
8003
+ * Upload request with table_name
7572
8004
  */
7573
- body: FileStatusUpdate;
8005
+ body: FileUploadRequest;
7574
8006
  path: {
7575
8007
  /**
7576
8008
  * Graph Id
7577
8009
  */
7578
8010
  graph_id: string;
7579
- /**
7580
- * File Id
7581
- * File identifier
7582
- */
7583
- file_id: string;
7584
8011
  };
7585
8012
  query?: never;
7586
- url: '/v1/graphs/{graph_id}/tables/files/{file_id}';
8013
+ url: '/v1/graphs/{graph_id}/files';
7587
8014
  };
7588
- export type UpdateFileStatusErrors = {
8015
+ export type CreateFileUploadErrors = {
7589
8016
  /**
7590
- * Invalid status, file too large, or empty file
8017
+ * Invalid file format or parameters
7591
8018
  */
7592
8019
  400: ErrorResponse;
7593
8020
  /**
@@ -7599,98 +8026,134 @@ export type UpdateFileStatusErrors = {
7599
8026
  */
7600
8027
  403: ErrorResponse;
7601
8028
  /**
7602
- * Graph, file, or S3 object not found
8029
+ * Graph not found
7603
8030
  */
7604
8031
  404: ErrorResponse;
7605
- /**
7606
- * Storage limit exceeded for tier
7607
- */
7608
- 413: ErrorResponse;
7609
8032
  /**
7610
8033
  * Validation Error
7611
8034
  */
7612
8035
  422: HttpValidationError;
8036
+ };
8037
+ export type CreateFileUploadError = CreateFileUploadErrors[keyof CreateFileUploadErrors];
8038
+ export type CreateFileUploadResponses = {
7613
8039
  /**
7614
- * Internal server error
8040
+ * Upload URL generated successfully
7615
8041
  */
7616
- 500: unknown;
8042
+ 200: FileUploadResponse;
8043
+ };
8044
+ export type CreateFileUploadResponse = CreateFileUploadResponses[keyof CreateFileUploadResponses];
8045
+ export type DeleteFileData = {
8046
+ body?: never;
8047
+ path: {
8048
+ /**
8049
+ * Graph Id
8050
+ */
8051
+ graph_id: string;
8052
+ /**
8053
+ * File Id
8054
+ * File ID
8055
+ */
8056
+ file_id: string;
8057
+ };
8058
+ query?: {
8059
+ /**
8060
+ * Cascade
8061
+ * If true, delete from all layers including DuckDB and mark graph stale
8062
+ */
8063
+ cascade?: boolean;
8064
+ };
8065
+ url: '/v1/graphs/{graph_id}/files/{file_id}';
7617
8066
  };
7618
- export type UpdateFileStatusError = UpdateFileStatusErrors[keyof UpdateFileStatusErrors];
7619
- export type UpdateFileStatusResponses = {
8067
+ export type DeleteFileErrors = {
7620
8068
  /**
7621
- * Response Updatefilestatus
7622
- * File status updated successfully
8069
+ * Not authenticated
7623
8070
  */
7624
- 200: {
7625
- [key: string]: unknown;
7626
- };
8071
+ 401: unknown;
8072
+ /**
8073
+ * Access denied - shared repositories or insufficient permissions
8074
+ */
8075
+ 403: ErrorResponse;
8076
+ /**
8077
+ * File not found
8078
+ */
8079
+ 404: ErrorResponse;
8080
+ /**
8081
+ * Validation Error
8082
+ */
8083
+ 422: HttpValidationError;
7627
8084
  };
7628
- export type UpdateFileStatusResponse = UpdateFileStatusResponses[keyof UpdateFileStatusResponses];
7629
- export type IngestTablesData = {
8085
+ export type DeleteFileError = DeleteFileErrors[keyof DeleteFileErrors];
8086
+ export type DeleteFileResponses = {
7630
8087
  /**
7631
- * Ingestion request
8088
+ * File deleted successfully
7632
8089
  */
7633
- body: BulkIngestRequest;
8090
+ 200: DeleteFileResponse;
8091
+ };
8092
+ export type DeleteFileResponse2 = DeleteFileResponses[keyof DeleteFileResponses];
8093
+ export type GetFileData = {
8094
+ body?: never;
7634
8095
  path: {
7635
8096
  /**
7636
8097
  * Graph Id
7637
8098
  */
7638
8099
  graph_id: string;
8100
+ /**
8101
+ * File Id
8102
+ * File ID
8103
+ */
8104
+ file_id: string;
7639
8105
  };
7640
8106
  query?: never;
7641
- url: '/v1/graphs/{graph_id}/tables/ingest';
8107
+ url: '/v1/graphs/{graph_id}/files/{file_id}';
7642
8108
  };
7643
- export type IngestTablesErrors = {
8109
+ export type GetFileErrors = {
7644
8110
  /**
7645
8111
  * Not authenticated
7646
8112
  */
7647
8113
  401: unknown;
7648
8114
  /**
7649
- * Access denied - shared repositories or insufficient permissions
8115
+ * Access denied - insufficient permissions
7650
8116
  */
7651
8117
  403: ErrorResponse;
7652
8118
  /**
7653
- * Graph not found
8119
+ * File not found
7654
8120
  */
7655
8121
  404: ErrorResponse;
7656
- /**
7657
- * Conflict - another ingestion is already in progress for this graph
7658
- */
7659
- 409: ErrorResponse;
7660
8122
  /**
7661
8123
  * Validation Error
7662
8124
  */
7663
8125
  422: HttpValidationError;
7664
- /**
7665
- * Ingestion failed - check per-table results for details
7666
- */
7667
- 500: ErrorResponse;
7668
8126
  };
7669
- export type IngestTablesError = IngestTablesErrors[keyof IngestTablesErrors];
7670
- export type IngestTablesResponses = {
8127
+ export type GetFileError = GetFileErrors[keyof GetFileErrors];
8128
+ export type GetFileResponses = {
7671
8129
  /**
7672
- * Ingestion completed with detailed per-table results
8130
+ * File information retrieved successfully
7673
8131
  */
7674
- 200: BulkIngestResponse;
8132
+ 200: GetFileInfoResponse;
7675
8133
  };
7676
- export type IngestTablesResponse = IngestTablesResponses[keyof IngestTablesResponses];
7677
- export type QueryTablesData = {
8134
+ export type GetFileResponse = GetFileResponses[keyof GetFileResponses];
8135
+ export type UpdateFileData = {
7678
8136
  /**
7679
- * SQL query request
8137
+ * Status update request
7680
8138
  */
7681
- body: TableQueryRequest;
8139
+ body: FileStatusUpdate;
7682
8140
  path: {
7683
8141
  /**
7684
8142
  * Graph Id
7685
8143
  */
7686
8144
  graph_id: string;
8145
+ /**
8146
+ * File Id
8147
+ * File ID
8148
+ */
8149
+ file_id: string;
7687
8150
  };
7688
8151
  query?: never;
7689
- url: '/v1/graphs/{graph_id}/tables/query';
8152
+ url: '/v1/graphs/{graph_id}/files/{file_id}';
7690
8153
  };
7691
- export type QueryTablesErrors = {
8154
+ export type UpdateFileErrors = {
7692
8155
  /**
7693
- * Invalid SQL query syntax or execution error
8156
+ * Invalid status or file not in S3
7694
8157
  */
7695
8158
  400: ErrorResponse;
7696
8159
  /**
@@ -7698,34 +8161,29 @@ export type QueryTablesErrors = {
7698
8161
  */
7699
8162
  401: unknown;
7700
8163
  /**
7701
- * Access denied - shared repositories or insufficient permissions
8164
+ * Access denied
7702
8165
  */
7703
8166
  403: ErrorResponse;
7704
8167
  /**
7705
- * Graph not found
8168
+ * File not found
7706
8169
  */
7707
8170
  404: ErrorResponse;
7708
- /**
7709
- * Query timeout exceeded
7710
- */
7711
- 408: unknown;
7712
8171
  /**
7713
8172
  * Validation Error
7714
8173
  */
7715
8174
  422: HttpValidationError;
7716
- /**
7717
- * Internal server error
7718
- */
7719
- 500: unknown;
7720
8175
  };
7721
- export type QueryTablesError = QueryTablesErrors[keyof QueryTablesErrors];
7722
- export type QueryTablesResponses = {
8176
+ export type UpdateFileError = UpdateFileErrors[keyof UpdateFileErrors];
8177
+ export type UpdateFileResponses = {
7723
8178
  /**
7724
- * Query executed successfully
8179
+ * Response Updatefile
8180
+ * File status updated successfully
7725
8181
  */
7726
- 200: TableQueryResponse;
8182
+ 200: {
8183
+ [key: string]: unknown;
8184
+ };
7727
8185
  };
7728
- export type QueryTablesResponse = QueryTablesResponses[keyof QueryTablesResponses];
8186
+ export type UpdateFileResponse = UpdateFileResponses[keyof UpdateFileResponses];
7729
8187
  export type GetGraphsData = {
7730
8188
  body?: never;
7731
8189
  path?: never;