@loams/client 0.1.0 → 0.1.2

package/dist/vendor/proto/gen/loams/sql/v1/sql_pb.d.ts

@@ -0,0 +1,182 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { ListValue, Value } from "@bufbuild/protobuf/wkt";
+import type { Consistency } from "../../collection/v1/document_pb.js";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file loams/sql/v1/sql.proto.
+ */
+export declare const file_loams_sql_v1_sql: GenFile;
+/**
+ * @generated from message loams.sql.v1.QueryRequest
+ */
+export type QueryRequest = Message<"loams.sql.v1.QueryRequest"> & {
+    /**
+     * The namespace whose collections are the statement's tables.
+     *
+     * @generated from field: string namespace = 1;
+     */
+    namespace: string;
+    /**
+     * One read-only SQL statement.
+     *
+     * @generated from field: string sql = 2;
+     */
+    sql: string;
+    /**
+     * The values of `$1…$n`, in order.
+     *
+     * @generated from field: repeated google.protobuf.Value params = 3;
+     */
+    params: Value[];
+    /**
+     * How fresh the read is; strong when unset.
+     *
+     * @generated from field: loams.collection.v1.Consistency consistency = 4;
+     */
+    consistency?: Consistency | undefined;
+    /**
+     * At most this many rows (default 10 000, at most 100 000).
+     *
+     * @generated from field: optional uint32 max_rows = 5;
+     */
+    maxRows?: number | undefined;
+};
+/**
+ * Describes the message loams.sql.v1.QueryRequest.
+ * Use `create(QueryRequestSchema)` to create a new message.
+ */
+export declare const QueryRequestSchema: GenMessage<QueryRequest>;
+/**
+ * One result column: its name and its Arrow type, as Arrow prints it
+ * (`Int64`, `Utf8`, `List(Float32)`).
+ *
+ * @generated from message loams.sql.v1.Column
+ */
+export type Column = Message<"loams.sql.v1.Column"> & {
+    /**
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * @generated from field: string type = 2;
+     */
+    type: string;
+};
+/**
+ * Describes the message loams.sql.v1.Column.
+ * Use `create(ColumnSchema)` to create a new message.
+ */
+export declare const ColumnSchema: GenMessage<Column>;
+/**
+ * @generated from message loams.sql.v1.QueryResponse
+ */
+export type QueryResponse = Message<"loams.sql.v1.QueryResponse"> & {
+    /**
+     * @generated from field: repeated loams.sql.v1.Column columns = 1;
+     */
+    columns: Column[];
+    /**
+     * One list per row, one value per column, in column order. A 64-bit
+     * integer past 2^53 is a decimal string, so it stays exact.
+     *
+     * @generated from field: repeated google.protobuf.ListValue rows = 2;
+     */
+    rows: ListValue[];
+    /**
+     * More rows existed than `max_rows` allowed.
+     *
+     * @generated from field: bool truncated = 3;
+     */
+    truncated: boolean;
+    /**
+     * The token the read was answered at, when it waited for one.
+     *
+     * @generated from field: string consistency_token = 4;
+     */
+    consistencyToken: string;
+};
+/**
+ * Describes the message loams.sql.v1.QueryResponse.
+ * Use `create(QueryResponseSchema)` to create a new message.
+ */
+export declare const QueryResponseSchema: GenMessage<QueryResponse>;
+/**
+ * @generated from message loams.sql.v1.QueryArrowRequest
+ */
+export type QueryArrowRequest = Message<"loams.sql.v1.QueryArrowRequest"> & {
+    /**
+     * @generated from field: string namespace = 1;
+     */
+    namespace: string;
+    /**
+     * @generated from field: string sql = 2;
+     */
+    sql: string;
+    /**
+     * @generated from field: repeated google.protobuf.Value params = 3;
+     */
+    params: Value[];
+    /**
+     * @generated from field: loams.collection.v1.Consistency consistency = 4;
+     */
+    consistency?: Consistency | undefined;
+    /**
+     * @generated from field: optional uint32 max_rows = 5;
+     */
+    maxRows?: number | undefined;
+};
+/**
+ * Describes the message loams.sql.v1.QueryArrowRequest.
+ * Use `create(QueryArrowRequestSchema)` to create a new message.
+ */
+export declare const QueryArrowRequestSchema: GenMessage<QueryArrowRequest>;
+/**
+ * @generated from message loams.sql.v1.QueryArrowResponse
+ */
+export type QueryArrowResponse = Message<"loams.sql.v1.QueryArrowResponse"> & {
+    /**
+     * The result as one Arrow IPC stream: the schema, then the batches.
+     *
+     * @generated from field: bytes arrow_ipc = 1;
+     */
+    arrowIpc: Uint8Array;
+    /**
+     * @generated from field: bool truncated = 2;
+     */
+    truncated: boolean;
+    /**
+     * @generated from field: string consistency_token = 3;
+     */
+    consistencyToken: string;
+};
+/**
+ * Describes the message loams.sql.v1.QueryArrowResponse.
+ * Use `create(QueryArrowResponseSchema)` to create a new message.
+ */
+export declare const QueryArrowResponseSchema: GenMessage<QueryArrowResponse>;
+/**
+ * @generated from service loams.sql.v1.SqlService
+ */
+export declare const SqlService: GenService<{
+    /**
+     * Runs one read-only statement and answers its rows.
+     *
+     * @generated from rpc loams.sql.v1.SqlService.Query
+     */
+    query: {
+        methodKind: "unary";
+        input: typeof QueryRequestSchema;
+        output: typeof QueryResponseSchema;
+    };
+    /**
+     * Runs one read-only statement and answers its result as an Arrow IPC
+     * stream.
+     *
+     * @generated from rpc loams.sql.v1.SqlService.QueryArrow
+     */
+    queryArrow: {
+        methodKind: "unary";
+        input: typeof QueryArrowRequestSchema;
+        output: typeof QueryArrowResponseSchema;
+    };
+}>;

package/dist/vendor/proto/gen/loams/sql/v1/sql_pb.js

@@ -0,0 +1,72 @@
+// SQL over a namespace's collections (design §44 §5.1; API2 Task 1; SDKP
+// P0b, docs/plans/2026-10-19-sdk-parity.md).
+//
+// `SqlService/Query` runs one read-only statement through the same
+// DataFusion context the native REST route (`POST /v1/namespaces/{ns}/sql`)
+// and Flight SQL use: the namespace's collections are its tables, the search
+// table functions are in scope, and anything that is not a query is
+// `invalid_argument`. Rows come back as JSON-shaped values; `QueryArrow`
+// answers the same result as one Arrow IPC stream for callers that read
+// Arrow.
+//
+// ## Parameters
+//
+// `params` binds the positional placeholders `$1…$n`, in order. A value is
+// cast to the type the planner inferred for its placeholder (`n > $1` on an
+// `i64` column binds a JSON number as an `Int64`), and a statement whose
+// placeholder count is not the number of values given is `invalid_argument`
+// with reason `sql_param_count`. Named placeholders (`$name`) are not
+// accepted. A list or an object is not a scalar and is refused.
+//
+// ## Limits
+//
+// `max_rows` (default 10 000, at most 100 000) caps the rows a statement
+// answers; `truncated` says more existed. A statement runs within the
+// server's SQL timeout. `QueryArrow`'s stream is capped at
+// `--sql-arrow-max-bytes` (16 MiB by default); over it the call is
+// `resource_exhausted` with reason `result_too_large` and `metadata.use =
+// "flight"`, because Flight SQL streams a result of any size.
+//
+// ## Consistency
+//
+// `consistency` is `loams.collection.v1.Consistency`, read by the same rule
+// as `GetDocuments`: `at_least` waits for a write's token, `pin` reads a
+// pinned version, and the `loams-consistency-token` request header merges
+// in.
+import { fileDesc, messageDesc, serviceDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_struct } from "@bufbuild/protobuf/wkt";
+import { file_loams_collection_v1_document } from "../../collection/v1/document_pb.js";
+import { file_loams_options_v1_options } from "../../options/v1/options_pb.js";
+/**
+ * Describes the file loams/sql/v1/sql.proto.
+ */
+export const file_loams_sql_v1_sql = /*@__PURE__*/ fileDesc("ChZsb2Ftcy9zcWwvdjEvc3FsLnByb3RvEgxsb2Ftcy5zcWwudjEisQEKDFF1ZXJ5UmVxdWVzdBIRCgluYW1lc3BhY2UYASABKAkSCwoDc3FsGAIgASgJEiYKBnBhcmFtcxgDIAMoCzIWLmdvb2dsZS5wcm90b2J1Zi5WYWx1ZRI1Cgtjb25zaXN0ZW5jeRgEIAEoCzIgLmxvYW1zLmNvbGxlY3Rpb24udjEuQ29uc2lzdGVuY3kSFQoIbWF4X3Jvd3MYBSABKA1IAIgBAUILCglfbWF4X3Jvd3MiJAoGQ29sdW1uEgwKBG5hbWUYASABKAkSDAoEdHlwZRgCIAEoCSKOAQoNUXVlcnlSZXNwb25zZRIlCgdjb2x1bW5zGAEgAygLMhQubG9hbXMuc3FsLnYxLkNvbHVtbhIoCgRyb3dzGAIgAygLMhouZ29vZ2xlLnByb3RvYnVmLkxpc3RWYWx1ZRIRCgl0cnVuY2F0ZWQYAyABKAgSGQoRY29uc2lzdGVuY3lfdG9rZW4YBCABKAkitgEKEVF1ZXJ5QXJyb3dSZXF1ZXN0EhEKCW5hbWVzcGFjZRgBIAEoCRILCgNzcWwYAiABKAkSJgoGcGFyYW1zGAMgAygLMhYuZ29vZ2xlLnByb3RvYnVmLlZhbHVlEjUKC2NvbnNpc3RlbmN5GAQgASgLMiAubG9hbXMuY29sbGVjdGlvbi52MS5Db25zaXN0ZW5jeRIVCghtYXhfcm93cxgFIAEoDUgAiAEBQgsKCV9tYXhfcm93cyJVChJRdWVyeUFycm93UmVzcG9uc2USEQoJYXJyb3dfaXBjGAEgASgMEhEKCXRydW5jYXRlZBgCIAEoCBIZChFjb25zaXN0ZW5jeV90b2tlbhgDIAEoCTKfAgoKU3FsU2VydmljZRJQCgVRdWVyeRIaLmxvYW1zLnNxbC52MS5RdWVyeVJlcXVlc3QaGy5sb2Ftcy5zcWwudjEuUXVlcnlSZXNwb25zZSIOkAIBkrUYBxIFcXVlcnkSZQoKUXVlcnlBcnJvdxIfLmxvYW1zLnNxbC52MS5RdWVyeUFycm93UmVxdWVzdBogLmxvYW1zLnNxbC52MS5RdWVyeUFycm93UmVzcG9uc2UiFJACAZK1GA0SC3F1ZXJ5X2Fycm93GliKtRhUCgNzcWwSTVNRTDogb25lIHJlYWQtb25seSBzdGF0ZW1lbnQgb3ZlciBhIG5hbWVzcGFjZSdzIGNvbGxlY3Rpb25zLCB3aXRoIHBhcmFtZXRlcnMuYgZwcm90bzM", [file_google_protobuf_struct, file_loams_collection_v1_document, file_loams_options_v1_options]);
+/**
+ * Describes the message loams.sql.v1.QueryRequest.
+ * Use `create(QueryRequestSchema)` to create a new message.
+ */
+export const QueryRequestSchema = /*@__PURE__*/ messageDesc(file_loams_sql_v1_sql, 0);
+/**
+ * Describes the message loams.sql.v1.Column.
+ * Use `create(ColumnSchema)` to create a new message.
+ */
+export const ColumnSchema = /*@__PURE__*/ messageDesc(file_loams_sql_v1_sql, 1);
+/**
+ * Describes the message loams.sql.v1.QueryResponse.
+ * Use `create(QueryResponseSchema)` to create a new message.
+ */
+export const QueryResponseSchema = /*@__PURE__*/ messageDesc(file_loams_sql_v1_sql, 2);
+/**
+ * Describes the message loams.sql.v1.QueryArrowRequest.
+ * Use `create(QueryArrowRequestSchema)` to create a new message.
+ */
+export const QueryArrowRequestSchema = /*@__PURE__*/ messageDesc(file_loams_sql_v1_sql, 3);
+/**
+ * Describes the message loams.sql.v1.QueryArrowResponse.
+ * Use `create(QueryArrowResponseSchema)` to create a new message.
+ */
+export const QueryArrowResponseSchema = /*@__PURE__*/ messageDesc(file_loams_sql_v1_sql, 4);
+/**
+ * @generated from service loams.sql.v1.SqlService
+ */
+export const SqlService = /*@__PURE__*/ serviceDesc(file_loams_sql_v1_sql, 0);