@restatedev/restatectl 1.2.0-alpha.1

package/README.md

@@ -0,0 +1,125 @@
+[![Documentation](https://img.shields.io/badge/doc-reference-blue)](https://docs.restate.dev)
+[![Examples](https://img.shields.io/badge/view-examples-blue)](https://github.com/restatedev/examples)
+[![Discord](https://img.shields.io/discord/1128210118216007792?logo=discord)](https://discord.gg/skW3AZ6uGd)
+[![Twitter](https://img.shields.io/twitter/follow/restatedev.svg?style=social&label=Follow)](https://twitter.com/intent/follow?screen_name=restatedev)
+
+# Restate - Building resilient applications made easy!
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://restate.dev/poster_intro_dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="https://restate.dev/poster_intro_2.svg">
+    <img alt="Restate overview" src="https://restate.dev/poster_intro_2.svg" width="500">
+  </picture>
+</p>
+
+Easily build workflows, event-driven applications, and distributed services in a fault-tolerant manner with durable async/await.
+
+[Restate](https://restate.dev) is great at building:
+
+* [Lambda Workflows as Code](https://restate.dev/blog/we-replaced-400-lines-of-stepfunctions-asl-with-40-lines-of-typescript-by-making-lambdas-suspendable/)
+* [Transactional RPC Handlers](https://github.com/restatedev/examples/tree/main/end-to-end-applications/typescript/food-ordering)
+* [Event Processing with Kafka](https://restate.dev/blog/restate--kafka-event-driven-apps-where-event-driven-is-an-implementation-detail/)
+* [Much more](https://github.com/restatedev/examples)
+
+## Get started with Restate
+
+1. 🏎 [Check out our quickstart](https://docs.restate.dev/get_started/quickstart) to get up and running with Restate in 2 minutes!
+1. 💡 [The tour of Restate](https://docs.restate.dev/get_started/tour) walks you through all features of Restate.
+
+## SDKs
+
+Restate supports the following SDKs:
+
+* [Typescript](https://github.com/restatedev/sdk-typescript)
+* [Java and Kotlin](https://github.com/restatedev/sdk-java)
+* [Python](https://github.com/restatedev/sdk-python)
+* [Go](https://github.com/restatedev/sdk-go)
+* [Rust](https://github.com/restatedev/sdk-rust)
+
+## Install
+
+We offer pre-built binaries of the CLI and the server for MacOS and Linux.
+
+### Install the server
+
+Install via Homebrew:
+```bash
+brew install restatedev/tap/restate-server
+```
+
+Run via npx:
+```bash
+npx @restatedev/restate-server
+```
+
+Run via docker:
+```bash
+docker run --rm -it --network=host docker.io/restatedev/restate:latest
+```
+
+### Install the CLI
+
+Install via Homebrew:
+```bash
+brew install restatedev/tap/restate
+```
+
+Install via npm:
+```bash
+npm install --global @restatedev/restate
+```
+
+Run via npx:
+```bash
+npx @restatedev/restate
+```
+
+You can also download the binaries from the [release page](https://github.com/restatedev/restate/releases) or our [download page](https://restate.dev/get-restate/).
+
+## Community
+
+* 🤗️ [Join our online community](https://discord.gg/skW3AZ6uGd) for help, sharing feedback and talking to the community.
+* 📖 [Check out our documentation](https://docs.restate.dev) to get quickly started!
+* 📣 [Follow us on Twitter](https://twitter.com/restatedev) for staying up to date.
+* 🙋 [Create a GitHub issue](https://github.com/restatedev/restate/issues) for requesting a new feature or reporting a problem.
+* 🏠 [Visit our GitHub org](https://github.com/restatedev) for exploring other repositories.
+
+## Core primitives
+
+The basic primitives Restate offers to simplify application development are the following:
+
+* **Reliable Execution**: user code will always run to completion. Intermediate failures result in re-tries that use the durable execution mechanism to recover partial progress and not duplicate already executed steps.
+* **Suspending User Code**: long-running user code suspends when awaiting on a promise and resume when that promise is resolved.
+* **Reliable Communication**: user code communicates with exactly-once semantics. Restate reliably delivers messages and anchors both sender and receiver in the durable execution to ensure no losses or duplicates can happen.
+* **Durable Timers**: user code can sleep (and suspend) or schedule calls for later.
+* **Isolation**: user code can be keyed, which makes Restate scheduled them to obey single-writer-per-key semantics.
+* **Consistent State**: keyed user code can attach key/value state, which is eagerly pushed into handlers during invocation, and written back upon completion. This is particularly efficient for FaaS deployments (stateful serverless, yay!).
+* **Observability & Introspection**: Restate automatically generates Open Telemetry traces for the interactions between handlers and gives you a SQL shell to query the distributed state of the application.
+
+## Contributing
+
+We’re excited if you join the Restate community and start contributing!
+Whether it is feature requests, bug reports, ideas & feedback or PRs, we appreciate any and all contributions.
+We know that your time is precious and, therefore, deeply value any effort to contribute!
+
+Check out our [development guidelines](/docs/dev/development-guidelines.md) and [tips for local development](/docs/dev/local-development.md) to get started.
+
+## Versions
+
+Restate follows [Semantic Versioning](https://semver.org/).
+
+You can safely upgrade from a Restate `x.y` to `x.(y+1)` release without performing any manual data migration, as Restate performs an automatic data migration for you.
+
+For SDK compatibility, refer to the supported version matrix in the respective READMEs:
+
+* [Restate Java SDK](https://github.com/restatedev/sdk-java#versions)
+* [Restate TypeScript SDK](https://github.com/restatedev/sdk-typescript#versions)
+* [Restate Go SDK](https://github.com/restatedev/sdk-go#versions)
+* [Restate Python SDK](https://github.com/restatedev/sdk-python#versions)
+* [Restate Rust SDK](https://github.com/restatedev/sdk-rust#versions)
+
+### Building Restate locally
+
+In order to build Restate locally [follow the build instructions](https://github.com/restatedev/restate/blob/main/docs/dev/local-development.md#building-restate).
+

package/lib/index.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+"use strict";
+/*
+ * Copyright (c) 2023 - 2025 Restate Software, Inc., Restate GmbH.
+ * All rights reserved.
+ *
+ * Use of this software is governed by the Business Source License
+ * included in the LICENSE file.
+ *
+ * As of the Change Date specified in that file, in accordance with
+ * the Business Source License, use of this software will be governed
+ * by the Apache License, Version 2.0.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const node_os_1 = __importDefault(require("node:os"));
+function getExePath() {
+    const arch = node_os_1.default.arch();
+    const op = node_os_1.default.platform();
+    try {
+        return require.resolve(`@restatedev/restatectl-${op}-${arch}/bin/restatectl`);
+    }
+    catch (e) {
+        throw new Error(`Couldn't find application binary inside node_modules for ${op}-${arch}`);
+    }
+}
+function run() {
+    var _a;
+    const args = process.argv.slice(2);
+    const processResult = (0, child_process_1.spawnSync)(getExePath(), args, { stdio: "inherit" });
+    process.exit((_a = processResult.status) !== null && _a !== void 0 ? _a : 0);
+}
+run();

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@restatedev/restatectl",
+  "description": "Restate administration tools",
+  "version": "1.2.0-alpha.1",
+  "bin": "lib/index.js",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/restatedev/restate.git"
+  },
+  "publishConfig": {
+    "@restatedev:registry": "https://registry.npmjs.org"
+  },
+  "author": "Restate Developers",
+  "license": "BSL",
+  "email": "code@restate.dev",
+  "homepage": "https://github.com/restatedev/restate#readme",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "build": "tsc",
+    "dev": "npm run build && node lib/index.js"
+  },
+  "dependencies": {
+    "@scarf/scarf": "^1.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^18.11.18",
+    "@typescript-eslint/eslint-plugin": "^5.48.0",
+    "@typescript-eslint/parser": "^5.48.0",
+    "eslint": "^8.31.0",
+    "typescript": "^4.9.4"
+  },
+  "optionalDependencies": {
+    "@restatedev/restatectl-linux-x64": "1.2.0-alpha.1",
+    "@restatedev/restatectl-linux-arm64": "1.2.0-alpha.1",
+    "@restatedev/restatectl-darwin-x64": "1.2.0-alpha.1",
+    "@restatedev/restatectl-darwin-arm64": "1.2.0-alpha.1"
+  }
+}

package/src/index.ts

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+/*
+ * Copyright (c) 2023 - 2025 Restate Software, Inc., Restate GmbH.
+ * All rights reserved.
+ *
+ * Use of this software is governed by the Business Source License
+ * included in the LICENSE file.
+ *
+ * As of the Change Date specified in that file, in accordance with
+ * the Business Source License, use of this software will be governed
+ * by the Apache License, Version 2.0.
+ */
+
+import { spawnSync } from "child_process";
+import os from "node:os";
+
+function getExePath() {
+  const arch = os.arch();
+  const op = os.platform();
+
+  try {
+    return require.resolve(
+      `@restatedev/restatectl-${op}-${arch}/bin/restatectl`,
+    );
+  } catch (e) {
+    throw new Error(
+      `Couldn't find application binary inside node_modules for ${op}-${arch}`,
+    );
+  }
+}
+
+function run() {
+  const args = process.argv.slice(2);
+  const processResult = spawnSync(getExePath(), args, { stdio: "inherit" });
+  process.exit(processResult.status ?? 0);
+}
+
+run();

package/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "es2016",
+    "module": "commonjs",
+    "esModuleInterop": true,
+    "baseUrl": "./",
+    "outDir": "lib",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "skipLibCheck": true
+  }
+}