@loams/client 0.0.0-stage → 0.1.0

package/dist/vendor/proto/gen/loams/options/v1/options_pb.d.ts

@@ -0,0 +1,97 @@
+import type { GenExtension, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { MethodOptions, ServiceOptions } from "@bufbuild/protobuf/wkt";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file loams/options/v1/options.proto.
+ */
+export declare const file_loams_options_v1_options: GenFile;
+/**
+ * The SDK module a service belongs to, set on the service.
+ *
+ * @generated from message loams.options.v1.ModuleOptions
+ */
+export type ModuleOptions = Message<"loams.options.v1.ModuleOptions"> & {
+    /**
+     * The module's name in `snake_case`, for example "vector" or "admin.org".
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     * One line for the module's reference docs.
+     *
+     * @generated from field: string summary = 2;
+     */
+    summary: string;
+    /**
+     * True for a package whose wire contract may still change: `buf breaking`
+     * skips it and SDKs mark the module experimental (§44 §10.3). The first
+     * such package is `loams.live.v1` (R1), which carries this option when its
+     * server-side service lands in R1 Task 12 — annotating it earlier would
+     * change the descriptor the committed `sdks/live-typescript` output was
+     * generated from.
+     *
+     * @generated from field: bool unstable = 3;
+     */
+    unstable: boolean;
+};
+/**
+ * Describes the message loams.options.v1.ModuleOptions.
+ * Use `create(ModuleOptionsSchema)` to create a new message.
+ */
+export declare const ModuleOptionsSchema: GenMessage<ModuleOptions>;
+/**
+ * One facade call backed by a method, set on the method.
+ *
+ * `QueryService/Search` backs two calls (`loams.vector.search` and
+ * `loams.search.query`) of one RPC, so this option is repeated: the facade
+ * reads each entry as a separate method on a module (§44 §7.3).
+ *
+ * @generated from message loams.options.v1.FacadeOptions
+ */
+export type FacadeOptions = Message<"loams.options.v1.FacadeOptions"> & {
+    /**
+     * The module the call is exposed in; empty means the service's module.
+     *
+     * @generated from field: string module = 1;
+     */
+    module: string;
+    /**
+     * The call's name in `snake_case`; empty means the method name.
+     *
+     * @generated from field: string name = 2;
+     */
+    name: string;
+    /**
+     * Overrides the retry class the facade derives from `idempotency_level`
+     * and the presence of an `idempotency_key` (D610): true lets the SDK
+     * retry the call on its own.
+     *
+     * @generated from field: bool retry_safe = 3;
+     */
+    retrySafe: boolean;
+    /**
+     * AIP-158 pagination as "<items field>:<next page token field>", for
+     * example "collections:next_page_token"; the facade adds a `list_all`
+     * iterator for it.
+     *
+     * @generated from field: string pagination = 4;
+     */
+    pagination: string;
+};
+/**
+ * Describes the message loams.options.v1.FacadeOptions.
+ * Use `create(FacadeOptionsSchema)` to create a new message.
+ */
+export declare const FacadeOptionsSchema: GenMessage<FacadeOptions>;
+/**
+ * Extension numbers 50001-50099 are this package's; the 50000-99999 range
+ * is the one protobuf reserves for an organisation's own options.
+ *
+ * @generated from extension: loams.options.v1.ModuleOptions module = 50001;
+ */
+export declare const module: GenExtension<ServiceOptions, ModuleOptions>;
+/**
+ * @generated from extension: repeated loams.options.v1.FacadeOptions facade = 50002;
+ */
+export declare const facade: GenExtension<MethodOptions, FacadeOptions[]>;

package/dist/vendor/proto/gen/loams/options/v1/options_pb.js

@@ -0,0 +1,47 @@
+// The annotations that drive the SDK facade (design §44 §7.3, D606; API1
+// Task 1).
+//
+// Every public `loams.<service>.v1` service names the SDK module it belongs
+// to (`loams.collections`, `loams.vector`, `loams.admin.org`, ...), and a
+// method may name the facade call or calls it backs.
+// `protoc-gen-loams-facade` (SDK1 Task 3) reads these options out of the
+// descriptor set and renders one facade per language from the templates in
+// `sdks/templates/<lang>/`, so the thirteen SDKs cannot drift. The server
+// ignores them at runtime: an option is metadata for the generator, never
+// behaviour.
+//
+// This package is deliberately not in any SDK's wire surface: it declares no
+// message of its own that a client sends, and no SDK method takes or returns
+// one. `buf generate` does list it, because a service that carries these
+// annotations has them in its descriptor and `protoc-gen-es` writes that
+// import into the generated file. SDK2 Task 0 found this: annotating
+// `loams.instance.v1.InstanceService` for the SDK facade made
+// `buf.gen.apps.yaml` generate `loams/options/v1/options_pb.ts`, which
+// `@loams/proto/options` then re-exports.
+import { extDesc, fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+import { file_google_protobuf_descriptor } from "@bufbuild/protobuf/wkt";
+/**
+ * Describes the file loams/options/v1/options.proto.
+ */
+export const file_loams_options_v1_options = /*@__PURE__*/ fileDesc("Ch5sb2Ftcy9vcHRpb25zL3YxL29wdGlvbnMucHJvdG8SEGxvYW1zLm9wdGlvbnMudjEiQAoNTW9kdWxlT3B0aW9ucxIMCgRuYW1lGAEgASgJEg8KB3N1bW1hcnkYAiABKAkSEAoIdW5zdGFibGUYAyABKAgiVQoNRmFjYWRlT3B0aW9ucxIOCgZtb2R1bGUYASABKAkSDAoEbmFtZRgCIAEoCRISCgpyZXRyeV9zYWZlGAMgASgIEhIKCnBhZ2luYXRpb24YBCABKAk6WgoGbW9kdWxlEh8uZ29vZ2xlLnByb3RvYnVmLlNlcnZpY2VPcHRpb25zGNGGAyABKAsyHy5sb2Ftcy5vcHRpb25zLnYxLk1vZHVsZU9wdGlvbnNSBm1vZHVsZTpZCgZmYWNhZGUSHi5nb29nbGUucHJvdG9idWYuTWV0aG9kT3B0aW9ucxjShgMgAygLMh8ubG9hbXMub3B0aW9ucy52MS5GYWNhZGVPcHRpb25zUgZmYWNhZGViBnByb3RvMw", [file_google_protobuf_descriptor]);
+/**
+ * Describes the message loams.options.v1.ModuleOptions.
+ * Use `create(ModuleOptionsSchema)` to create a new message.
+ */
+export const ModuleOptionsSchema = /*@__PURE__*/ messageDesc(file_loams_options_v1_options, 0);
+/**
+ * Describes the message loams.options.v1.FacadeOptions.
+ * Use `create(FacadeOptionsSchema)` to create a new message.
+ */
+export const FacadeOptionsSchema = /*@__PURE__*/ messageDesc(file_loams_options_v1_options, 1);
+/**
+ * Extension numbers 50001-50099 are this package's; the 50000-99999 range
+ * is the one protobuf reserves for an organisation's own options.
+ *
+ * @generated from extension: loams.options.v1.ModuleOptions module = 50001;
+ */
+export const module = /*@__PURE__*/ extDesc(file_loams_options_v1_options, 0);
+/**
+ * @generated from extension: repeated loams.options.v1.FacadeOptions facade = 50002;
+ */
+export const facade = /*@__PURE__*/ extDesc(file_loams_options_v1_options, 1);

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@loams/client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "The Loams SDK for TypeScript and JavaScript: one Loams object with namespaced modules over the unified Connect API, generated from proto/.",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/ostrium-labs/loams/tree/dev/sdks/typescript",
+  "bugs": "https://github.com/ostrium-labs/loams/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ostrium-labs/loams.git",
+    "directory": "sdks/typescript/packages/client"
+  },
+  "keywords": [
+    "loams",
+    "connect",
+    "grpc",
+    "sdk",
+    "database"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "default": "./dist/node.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "2.16.0",
+    "@connectrpc/connect": "2.2.0",
+    "@connectrpc/connect-node": "2.2.0",
+    "@connectrpc/connect-web": "2.2.0",
+    "@loams/live": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}