@spine-event-engine/client-node 2.0.0-snapshot.11

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,106 @@
+# Spine client for Node.js
+
+Use this package from a Node.js ESM application to post commands, send queries,
+or create subscriptions for query-side views. It owns the Node HTTP/2 transport;
+the request and subscription API is shared with the browser client.
+
+This is an experimental snapshot. Install the snapshot explicitly while its API
+and packaging continue to evolve:
+
+```sh
+pnpm add @spine-event-engine/client-node@snapshot
+```
+
+For detailed public contracts, lifecycle rules, and limits, read the
+[reference](REFERENCE.md).
+
+## 💡 Who should use it?
+
+- ✅ Node.js services, workers, and command-line applications that call a Spine
+  application gateway.
+- ✅ Applications that already own a generated Spine model package and a
+  reachable local or deployed Spine service.
+- ❌ Browser applications; use `@spine-event-engine/client-web` instead.
+
+## 🚀 Post a command to a local application
+
+Before running this example, use Node.js with ESM support, generate and build
+your application's Proto model, and start that application's local Spine
+service. For the concrete Message Board workspace walkthrough, clone this
+repository, run `pnpm install --frozen-lockfile && pnpm typecheck:build`, then
+start `pnpm --dir examples/message-board/app start`. That command starts the
+single-tenant local service at `http://127.0.0.1:8090`.
+
+The imports below are the Message Board workspace model contract: its
+`package.json` exports compiled `generated/*.js` modules after the setup above.
+They are not an installable dependency for an external application. In your
+application, depend on your own generated model package and replace this model
+package name and generated export paths with the ones declared by its
+`package.json` and `spine-proto.json`.
+
+Create one client for the component that manages the connection. A client from
+`connectTo()` owns its HTTP/2 session, so always close it.
+
+<!-- docs-snippet-path: examples/message-board/app/src/index.ts -->
+
+```ts
+import { create } from "@bufbuild/protobuf";
+import { timestampFromDate } from "@bufbuild/protobuf/wkt";
+import { Client } from "@spine-event-engine/client-node";
+import { PostMessageSchema } from "@spine-event-engine/example-message-board-model/generated/spine/examples/messageboard/commands_pb.js";
+import {
+  BoardIdSchema,
+  MessageIdSchema,
+} from "@spine-event-engine/example-message-board-model/generated/spine/examples/messageboard/message_board_pb.js";
+import { UserIdSchema } from "@spine-event-engine/example-message-board-model/generated/spine/examples/messageboard/user_pb.js";
+
+const client = Client.connectTo("http://127.0.0.1:8090");
+const request = client.onBehalfOf("alice");
+const result = await request.post(
+  PostMessageSchema,
+  create(PostMessageSchema, {
+    id: create(MessageIdSchema, { value: "message-1" }),
+    board: create(BoardIdSchema, { value: "general" }),
+    author: create(UserIdSchema, { value: "alice" }),
+    username: "Alice",
+    text: "Hello, Message Board.",
+    postedAt: timestampFromDate(new Date()),
+  }),
+);
+if (result.kind !== "ok") throw new Error(`Message was not accepted: ${result.kind}`);
+await client.close();
+```
+
+The URL is an application gateway URL. It is not an instruction to expose a
+Spine server directly to the internet. A successful call is an observation that
+the local service accepted the command; handle rejection and error outcomes in
+your application instead of assuming every command succeeds.
+
+## 🔎 Query generated entities
+
+Generate entity columns from the model package, register them once, and build
+queries with those declared columns. The `./codegen` entry point is for model
+generation; applications use the generated definition and `EntityQuery`.
+`limit()` requires an ordering. Only generated columns for the selected Entity
+may be used in its predicates.
+
+The [reference](REFERENCE.md) documents the query builder and its column-safety
+rules.
+
+## ⚠️ Cleanup and limits
+
+The client does not make a server safe for public access. Put the authenticated
+application gateway at the network boundary. Commands are not retried
+automatically, and an interrupted subscription must be recreated before the
+application re-reads current entity state.
+
+Node subscriptions use the same `createSubscription`, `activate`, and `cancel`
+API as the browser client; see the [client-web reference](https://github.com/SpineEventEngine/spine-ts/blob/master/packages/client-web/REFERENCE.md)
+for lifecycle and recovery limits. Close the client during process shutdown so
+its owned HTTP/2 session and subscriptions can finish cleanup.
+
+## 🔗 Learn more
+
+- [Browser client](https://github.com/SpineEventEngine/spine-ts/blob/master/packages/client-web/README.md)
+- [Server](https://github.com/SpineEventEngine/spine-ts/blob/master/packages/server/README.md)
+- [Detailed coding-agent reference](REFERENCE.md)

package/REFERENCE.md

@@ -0,0 +1,22 @@
+# @spine-event-engine/client-node reference
+
+This reference records the exact public contract of `@spine-event-engine/client-node`.
+Start with the [Node client overview](README.md) for the shortest connection path.
+
+## Client construction
+
+`Client.connectTo(baseUrl, options)` creates a shared `client-web` `Client` with a Node Connect HTTP/2 session. `client.close()` closes subscriptions and then aborts that session. `Client.usingTransport(transport, options)` uses a Connect transport supplied by the caller; closing the returned client does not close the supplied transport. Each `post()` creates its Command through the shared core signal-envelope helper, which assigns a fresh secure UUID-based Command ID.
+
+The returned kernel supports `asGuest()` and `onBehalfOf(user)` request scopes. A scope has `post(schema, value, options)`, `send(query, options)`, and `createSubscription(topic, options)`. See the [client-web reference](../client-web/REFERENCE.md) for command outcomes, cancellation, subscription lifecycle, recovery, and terminal behavior shared by both clients.
+
+## Entity query API
+
+`EntityColumn.register(schema, definition)` validates and binds generated columns to one Entity schema. The generated `EntityColumnDefinition` comes from the package's `./codegen` entry point. `EntityQuery.select({ schema, columns, context })` starts a builder. It supports `where`, `orderBy`, `limit`, and `build`, plus static predicates `eq`, `gt`, `lt`, `ge`, `le`, `all`, and `either`.
+
+Predicates accept only columns registered for the selected Entity. `limit()` requires at least one order clause. The compiler packs declared values and the `version`, `archived`, and `deleted` system columns into the wire query. Builders and columns are immutable, so a predicate cannot be reused for a different Entity target.
+
+## Code generation
+
+Use `protoc-gen-spine-entity-columns` or the `@spine-event-engine/client-node/codegen` entry point only from a model-generation workflow. Generated code uses `GeneratedEntityColumns`; application code should import the generated definition, register it, and construct queries through the public API above.
+
+This package is Node-only because it imports Node HTTP/2 and code-generation dependencies. Browser applications use `@spine-event-engine/client-web`.

package/codegen/entity-field-classification.d.mts

@@ -0,0 +1,25 @@
+import type { DescField } from "@bufbuild/protobuf";
+
+export type EntityFieldClassification =
+  | Readonly<{ supported: false; reason: "singular" | "oneof" }>
+  | Readonly<{
+      supported: true;
+      valueKind: "bigint" | "boolean" | "bytes" | "enum" | "message" | "number" | "string";
+      messageType?: string;
+      comparison: "equality" | "ordering";
+    }>;
+
+/**
+ * Classifies Protobuf descriptors used by the Entity-column generator.
+ */
+export declare const EntityFieldClassification: Readonly<{
+  // prettier-ignore
+
+  /**
+   * Classifies one Protobuf field descriptor.
+   *
+   * @param field Field descriptor supplied by the generator.
+   * @returns The Entity-column classification.
+   */
+  classify(field: DescField): EntityFieldClassification;
+}>;

package/codegen/entity-field-classification.mjs

@@ -0,0 +1,68 @@
+const scalarBool = 8;
+const scalarBytes = 12;
+const scalarInt64 = 3;
+const scalarUint64 = 4;
+const scalarFixed64 = 6;
+const scalarSfixed64 = 16;
+const scalarSint64 = 18;
+
+/**
+ * Classifies Protobuf fields for Entity-column generation and registration.
+ */
+export const EntityFieldClassification = Object.freeze({
+  // prettier-ignore
+
+  /**
+   * Classifies one field without depending on generated Spine descriptors.
+   *
+   * @param field Protobuf field descriptor supplied by the generator.
+   * @returns The supported value and comparison classification.
+   */
+  classify(field) {
+    if (field.fieldKind === "list" || field.fieldKind === "map") {
+      return { supported: false, reason: "singular" };
+    }
+    if (field.oneof !== undefined) {
+      return { supported: false, reason: "oneof" };
+    }
+    if (field.fieldKind === "enum") {
+      return { supported: true, valueKind: "enum", comparison: "equality" };
+    }
+    if (field.fieldKind === "message") {
+      const messageType = field.message.typeName;
+      return {
+        supported: true,
+        valueKind: "message",
+        messageType,
+        comparison:
+          messageType === "google.protobuf.Timestamp" || messageType === "spine.core.Version"
+            ? "ordering"
+            : "equality",
+      };
+    }
+    if (field.scalar === scalarBool) {
+      return { supported: true, valueKind: "boolean", comparison: "equality" };
+    }
+    if (field.scalar === scalarBytes) {
+      return { supported: true, valueKind: "bytes", comparison: "equality" };
+    }
+    if (
+      field.scalar === scalarInt64 ||
+      field.scalar === scalarUint64 ||
+      field.scalar === scalarFixed64 ||
+      field.scalar === scalarSfixed64 ||
+      field.scalar === scalarSint64
+    ) {
+      return {
+        supported: true,
+        valueKind: field.longAsString ? "string" : "bigint",
+        comparison: "ordering",
+      };
+    }
+    return {
+      supported: true,
+      valueKind: field.scalar === 9 ? "string" : "number",
+      comparison: "ordering",
+    };
+  },
+});

package/codegen/generate-entity-columns.mjs

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+import { getOption, hasOption } from "@bufbuild/protobuf";
+import { createEcmaScriptPlugin, runNodeJs } from "@bufbuild/protoplugin";
+import { fileURLToPath } from "node:url";
+import { resolve } from "node:path";
+import process from "node:process";
+import { EntityFieldClassification } from "./entity-field-classification.mjs";
+
+/**
+ * Generates typed Entity-column companions from Spine Protobuf input.
+ */
+export const EntityColumnGenerator = Object.freeze({
+  // prettier-ignore
+
+  /**
+   * Resolves Spine option descriptors supplied in the protoc plugin request.
+   *
+   * @param schema Plugin schema containing input files and dependencies.
+   * @returns The Entity and column option descriptors.
+   */
+  resolveOptions(schema) {
+    let entity;
+    let column;
+    const pending = [...schema.allFiles];
+    const visited = new Set();
+    while (pending.length > 0) {
+      const file = pending.pop();
+      if (file === undefined || visited.has(file)) continue;
+      visited.add(file);
+      pending.push(...(file.dependencies ?? []));
+      const descriptors = [...(file.extensions ?? []), ...schema.typesInFile(file)];
+      for (const descriptor of descriptors) {
+        if (descriptor.kind !== "extension") continue;
+        if (
+          descriptor.name === "entity" &&
+          descriptor.extendee.typeName === "google.protobuf.MessageOptions" &&
+          descriptor.file.proto.name === "spine/options.proto"
+        ) {
+          entity = descriptor;
+        }
+        if (
+          descriptor.name === "column" &&
+          descriptor.extendee.typeName === "google.protobuf.FieldOptions" &&
+          descriptor.file.proto.name === "spine/options.proto"
+        ) {
+          column = descriptor;
+        }
+      }
+    }
+    if (entity === undefined || column === undefined) {
+      throw new Error("The plugin request must include spine/options.proto descriptors.");
+    }
+    const kindField = entity.message.fields.find((field) => field.name === "kind");
+    if (kindField?.fieldKind !== "enum") {
+      throw new Error("The Spine entity option descriptor must declare entity kinds.");
+    }
+    return { entity, column };
+  },
+
+  /**
+   * Returns top-level queryable Entity messages in an input file.
+   *
+   * @param file Protobuf file being generated.
+   * @param options Resolved Spine option descriptors.
+   * @returns Queryable Entity message descriptors.
+   */
+  entities(file, options) {
+    return file.messages.filter(
+      (message) =>
+        message.parent === undefined &&
+        hasOption(message, options.entity) &&
+        ["AGGREGATE", "PROJECTION", "PROCESS_MANAGER"].includes(
+          options.entity.message.fields
+            .find((field) => field.name === "kind")
+            ?.enum?.values.find((value) => value.number === getOption(message, options.entity).kind)
+            ?.name,
+        ),
+    );
+  },
+
+  /**
+   * Reports whether a field carries Spine's `(column) = true` option.
+   *
+   * @param field Candidate Entity state field.
+   * @param options Resolved Spine option descriptors.
+   * @returns Whether the field is queryable.
+   */
+  isColumn(field, options) {
+    return hasOption(field, options.column) && getOption(field, options.column);
+  },
+
+  /**
+   * Derives the comparison family for a Protobuf field descriptor.
+   *
+   * @param field Candidate queryable Entity field.
+   * @returns The generated comparison family.
+   */
+  comparison(field) {
+    const classification = EntityFieldClassification.classify(field);
+    if (!classification.supported) {
+      throw new TypeError(
+        classification.reason === "singular"
+          ? `Entity column "${field.localName}" must be singular; repeated and map fields are unsupported.`
+          : `Entity column "${field.localName}" cannot belong to a oneof.`,
+      );
+    }
+    return classification.comparison;
+  },
+
+  /**
+   * Generates deterministic companions for all queryable Entities in a request.
+   *
+   * @param schema Plugin schema used to create generated files.
+   * @returns Nothing after emitting zero or more companions.
+   */
+  generate(schema) {
+    const candidateFiles = schema.files.filter((file) =>
+      (file.proto.dependency ?? []).includes("spine/options.proto"),
+    );
+    if (candidateFiles.length === 0) return;
+    const options = EntityColumnGenerator.resolveOptions(schema);
+    for (const file of candidateFiles) {
+      const entities = EntityColumnGenerator.entities(file, options);
+      if (entities.length === 0) continue;
+
+      const output = schema.generateFile(`${file.name}_columns.ts`);
+      const generatedColumns = output.import(
+        "GeneratedEntityColumns",
+        "@spine-event-engine/client-node/codegen",
+      );
+      const definitionType = output.import(
+        "EntityColumnDefinition",
+        "@spine-event-engine/client-node/codegen",
+        true,
+      );
+      output.preamble(file);
+
+      for (const entity of entities) {
+        const entitySchema = output.importSchema(entity);
+        const columnFields = entity.fields.filter((field) =>
+          EntityColumnGenerator.isColumn(field, options),
+        );
+        output.print(
+          output.export("const", `${entity.name}ColumnDefinition`),
+          ": ",
+          definitionType,
+          "<typeof ",
+          entitySchema,
+          ", {",
+        );
+        for (const field of columnFields) {
+          output.print(
+            `  readonly ${JSON.stringify(field.localName)}: { readonly field: typeof `,
+            entitySchema,
+            `.field[${JSON.stringify(field.localName)}]; readonly comparison: ${JSON.stringify(EntityColumnGenerator.comparison(field))} };`,
+          );
+        }
+        output.print("}> = ", generatedColumns, ".define(", entitySchema, ", {");
+        for (const field of columnFields) {
+          output.print(
+            `  ${JSON.stringify(field.localName)}: { field: `,
+            entitySchema,
+            `.field[${JSON.stringify(field.localName)}], comparison: ${JSON.stringify(EntityColumnGenerator.comparison(field))} },`,
+          );
+        }
+        output.print("});");
+      }
+    }
+  },
+});
+
+const entityColumnPlugin = createEcmaScriptPlugin({
+  name: "protoc-gen-spine-entity-columns",
+  version: "1.0.0",
+  generateTs: EntityColumnGenerator.generate,
+});
+
+if (process.argv[1] !== undefined && resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  runNodeJs(entityColumnPlugin);
+}

package/dist/client/node-client.d.ts

@@ -0,0 +1,24 @@
+import { Client as WebClient, type ClientOptions } from "@spine-event-engine/client-web";
+import type { Transport } from "@connectrpc/connect";
+/**
+ * Creates Node transport-backed instances of the shared browser-safe client kernel.
+ */
+export declare const Client: Readonly<{
+    /**
+     * Connects through a Node-owned HTTP/2 session.
+     *
+     * @param baseUrl Gateway base URL.
+     * @param options Shared client construction options.
+     * @returns A client that closes its owned HTTP/2 session.
+     */
+    connectTo(baseUrl: string, options?: ClientOptions): WebClient;
+    /**
+     * Uses a caller-owned Connect transport.
+     *
+     * @param transport Connect transport that remains caller-owned.
+     * @param options Shared client construction options.
+     * @returns A client that does not close the supplied transport.
+     */
+    usingTransport(transport: Transport, options?: ClientOptions): WebClient;
+}>;
+//# sourceMappingURL=node-client.d.ts.map

package/dist/client/node-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-client.d.ts","sourceRoot":"","sources":["../../src/client/node-client.ts"],"names":[],"mappings":"AAeA,OAAO,EACL,MAAM,IAAI,SAAS,EACnB,KAAK,aAAa,EAEnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,MAAM,EAAE,QAAQ,CAAC;IAG5B;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IAE/D;;;;;;OAMG;IACH,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;CAC1E,CAsBC,CAAC"}