@streamotter/cli 0.1.0-rc.1

package/dist/generate.js

@@ -0,0 +1,171 @@
+import { createHash } from "node:crypto";
+import { canonicalJson } from "@streamotter/contracts";
+export const GENERATED_MARKER = "// @generated by streamotter generate";
+const RESERVED = new Set([
+    "AppChannels", "ChannelContract", "Client", "Subscription", "Array", "Boolean", "Date", "Error", "Function", "JSON", "Map",
+    "Math", "Number", "Object", "Promise", "Record", "Set", "String", "Symbol"
+]);
+const IDENTIFIER = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+export function fingerprint(config) {
+    return createHash("sha256").update(canonicalJson(config)).digest("hex");
+}
+function pascalCase(id) {
+    return id.split(/[-_]+/).filter(Boolean).map(part => part[0].toUpperCase() + part.slice(1)).join("");
+}
+/** Maps schema IDs to unique, valid, non-shadowing TypeScript type names. */
+export function typeNames(schemaIds) {
+    const names = new Map();
+    const used = new Set();
+    for (const id of schemaIds) {
+        let name = pascalCase(id);
+        if (RESERVED.has(name))
+            name = `${name}Schema`;
+        let candidate = name;
+        for (let suffix = 2; used.has(candidate); suffix++)
+            candidate = `${name}${suffix}`;
+        used.add(candidate);
+        names.set(id, candidate);
+    }
+    return names;
+}
+function propertyKey(name) {
+    return IDENTIFIER.test(name) ? name : JSON.stringify(name);
+}
+function describe(schema) {
+    switch (schema.type) {
+        case "string": {
+            const parts = [];
+            if (schema.minLength !== undefined)
+                parts.push(`minLength ${schema.minLength}`);
+            if (schema.maxLength !== undefined)
+                parts.push(`maxLength ${schema.maxLength}`);
+            return parts.length > 0 ? parts.join(", ") : null;
+        }
+        case "number":
+        case "integer": {
+            const parts = [schema.type];
+            if (schema.minimum !== undefined)
+                parts.push(`minimum ${schema.minimum}`);
+            if (schema.maximum !== undefined)
+                parts.push(`maximum ${schema.maximum}`);
+            return schema.type === "integer" || parts.length > 1 ? parts.join(", ") : null;
+        }
+        case "array":
+            return `maxItems ${schema.maxItems}`;
+        default:
+            return null;
+    }
+}
+/** Renders a schema as a TypeScript type expression (type aliases, never interfaces, so values stay assignable to Json). */
+export function renderType(schema, indent = "") {
+    switch (schema.type) {
+        case "string":
+            return schema.enum !== undefined ? schema.enum.map(value => JSON.stringify(value)).join(" | ") : "string";
+        case "number":
+        case "integer":
+            return "number";
+        case "boolean":
+            return "boolean";
+        case "null":
+            return "null";
+        case "array": {
+            const item = renderType(schema.items, indent);
+            return /[|&]/.test(item) && !item.startsWith("{") ? `(${item})[]` : `${item}[]`;
+        }
+        case "object": {
+            const entries = Object.entries(schema.properties);
+            if (entries.length === 0)
+                return "Record<string, never>";
+            const inner = `${indent}  `;
+            const lines = entries.map(([name, child]) => {
+                const note = describe(child);
+                const comment = note === null ? "" : `${inner}/** ${note} */\n`;
+                const optional = schema.required.includes(name) ? "" : "?";
+                return `${comment}${inner}${propertyKey(name)}${optional}: ${renderType(child, inner)};`;
+            });
+            return `{\n${lines.join("\n")}\n${indent}}`;
+        }
+        default:
+            return "never";
+    }
+}
+/**
+ * Generates the application channel contract (AppChannels with each channel's
+ * parameter type, payload type, and literal version) plus a vanilla TypeScript
+ * integration example. Numeric ranges and string lengths remain runtime checks.
+ */
+export function generateFiles(config) {
+    const fp = fingerprint(config);
+    const header = `${GENERATED_MARKER} (config sha256:${fp}). Do not edit; rerun the generator.\n`;
+    const names = typeNames(Object.keys(config.schemas));
+    const schemaTypes = Object.entries(config.schemas).map(([id, schema]) => `/** Schema "${id}". */\nexport type ${names.get(id)} = ${renderType(schema)};`);
+    const channels = Object.entries(config.channels).map(([name, channel]) => `  ${propertyKey(name)}: ChannelContract<${names.get(channel.paramsSchema)}, ${names.get(channel.payloadSchema)}, ${channel.version}>;`);
+    const versions = Object.entries(config.channels).map(([name, channel]) => `  ${propertyKey(name)}: ${channel.version}`);
+    const types = [
+        header,
+        `import type { ChannelContract } from "@streamotter/client";`,
+        "",
+        ...schemaTypes.flatMap(block => [block, ""]),
+        `/** Channel contracts for createClient<AppChannels>(). Project "${config.projectId}". */`,
+        "export type AppChannels = {",
+        ...channels,
+        "};",
+        "",
+        "/** Deployed channel versions; subscribe requests must name them exactly. */",
+        "export const channelVersions = {",
+        versions.join(",\n"),
+        "} as const;",
+        ""
+    ].join("\n");
+    const [firstName, firstChannel] = Object.entries(config.channels)[0] ?? [];
+    const paramsSchema = firstChannel === undefined ? undefined : config.schemas[firstChannel.paramsSchema];
+    const exampleParams = paramsSchema?.type === "object"
+        ? `{ ${Object.entries(paramsSchema.properties).map(([key, schema]) => `${propertyKey(key)}: ${schema.type === "string" ? (schema.enum?.[0] !== undefined ? JSON.stringify(schema.enum[0]) : `"example"`) : schema.type === "boolean" ? "true" : "1"}`).join(", ")} }`
+        : "{}";
+    const example = firstName === undefined ? `${header}\nexport {};\n` : [
+        header,
+        `import { createClient, type StreamError, type SubscriptionState } from "@streamotter/client";`,
+        `import { channelVersions, type AppChannels } from "./streamotter.generated.js";`,
+        "",
+        "/**",
+        ` * Subscribes to "${firstName}" and returns a cleanup function. Replace render/showState/showError`,
+        " * with your view code. getToken must return your application's session token for the gateway.",
+        " */",
+        `export async function mount${pascalCase(firstName)}(options: {`,
+        "  origin: string;",
+        `  params: AppChannels[${JSON.stringify(firstName)}]["params"];`,
+        "  getToken: (signal: AbortSignal) => Promise<string>;",
+        `  render: (data: AppChannels[${JSON.stringify(firstName)}]["data"]) => void;`,
+        "  showState?: (state: SubscriptionState) => void;",
+        "  showError?: (error: StreamError) => void;",
+        "}): Promise<() => Promise<void>> {",
+        "  const client = createClient<AppChannels>({ origin: options.origin, getToken: ({ signal }) => options.getToken(signal) });",
+        `  const subscription = client.subscribe(${JSON.stringify(firstName)}, {`,
+        `    channelVersion: channelVersions[${JSON.stringify(firstName)}],`,
+        "    params: options.params",
+        "  });",
+        "  subscription.on(\"data\", event => options.render(event.data));",
+        "  subscription.on(\"state\", ({ state }) => options.showState?.(state));",
+        "  subscription.on(\"error\", error => options.showError?.(error));",
+        "  try {",
+        "    await subscription.ready({ timeoutMs: 30_000 });",
+        "  } catch (error) {",
+        "    await subscription.unsubscribe();",
+        "    await client.close();",
+        "    throw error;",
+        "  }",
+        "  return async () => {",
+        "    await subscription.unsubscribe();",
+        "    await client.close();",
+        "  };",
+        "}",
+        "",
+        `// Example: await mount${pascalCase(firstName)}({ origin: "http://localhost:${config.gateway.port}", params: ${exampleParams}, getToken, render });`,
+        ""
+    ].join("\n");
+    return [
+        { path: "streamotter.generated.ts", content: types },
+        { path: "streamotter.client.example.ts", content: example }
+    ];
+}
+//# sourceMappingURL=generate.js.map

package/dist/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { EXIT, runCli, type CliIO } from "./cli.ts";
+export { fingerprint, generateFiles, GENERATED_MARKER, renderType, typeNames, type GeneratedFile } from "./generate.ts";
+export { scaffoldFiles } from "./templates.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,eAAe,CAAC;AACxH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { EXIT, runCli } from "./cli.js";
+export { fingerprint, generateFiles, GENERATED_MARKER, renderType, typeNames } from "./generate.js";
+export { scaffoldFiles } from "./templates.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAc,MAAM,UAAU,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAsB,MAAM,eAAe,CAAC;AACxH,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,13 @@
+import { runCli } from "./cli.js";
+const shutdownSignal = new Promise(resolve => {
+    process.once("SIGINT", () => resolve("SIGINT"));
+    process.once("SIGTERM", () => resolve("SIGTERM"));
+});
+const code = await runCli(process.argv.slice(2), {
+    out: line => { process.stdout.write(`${line}\n`); },
+    err: line => { process.stderr.write(`${line}\n`); },
+    shutdownSignal
+});
+// Flush output, then exit even if a dependency left a handle open.
+process.stdout.write("", () => process.stderr.write("", () => process.exit(code)));
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,MAAM,cAAc,GAAG,IAAI,OAAO,CAAS,OAAO,CAAC,EAAE;IACnD,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IAC/C,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACnD,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACnD,cAAc;CACf,CAAC,CAAC;AACH,mEAAmE;AACnE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/templates.d.ts

@@ -0,0 +1,6 @@
+/** Files created by `streamotter init`. The scaffold is fixture-only and has no production credentials. */
+export declare function scaffoldFiles(projectId: string): {
+    path: string;
+    content: string;
+}[];
+//# sourceMappingURL=templates.d.ts.map

package/dist/templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAiKpF"}

package/dist/templates.js

@@ -0,0 +1,160 @@
+/** Files created by `streamotter init`. The scaffold is fixture-only and has no production credentials. */
+export function scaffoldFiles(projectId) {
+    const config = {
+        configVersion: 1,
+        projectId,
+        gateway: { host: "127.0.0.1", port: 7400, path: "/streamotter/socket.io", allowedOrigins: ["http://localhost:5173"] },
+        connections: {},
+        sources: { jobs: { kind: "fixture", generation: "jobs-fixture-1", fixtureRef: "jobs" } },
+        schemas: {
+            JobParams: {
+                type: "object", additionalProperties: false, required: ["jobId"],
+                properties: { jobId: { type: "string", minLength: 1, maxLength: 64 } }
+            },
+            JobProgress: {
+                type: "object", additionalProperties: false, required: ["jobId", "state", "percent"],
+                properties: {
+                    jobId: { type: "string", minLength: 1, maxLength: 64 },
+                    state: { type: "string", enum: ["queued", "running", "succeeded", "failed"] },
+                    percent: { type: "integer", minimum: 0, maximum: 100 }
+                }
+            }
+        },
+        channels: {
+            jobProgress: {
+                version: 1, source: "jobs", paramsSchema: "JobParams", payloadSchema: "JobProgress",
+                handlersRef: "jobProgress", delivery: { kind: "state", overflow: "resync" }
+            }
+        }
+    };
+    const handlers = `// @ts-check
+/**
+ * Trusted server handlers for StreamOtter, loaded by:
+ *   streamotter dev --config streamotter.json --handlers server/handlers.mjs
+ *
+ * StreamOtter loads compiled JavaScript. If you write handlers in TypeScript,
+ * compile them first and point --handlers at the output.
+ */
+
+/**
+ * Development read model. Replace it with your application's authoritative store.
+ * Snapshots and mapped records must describe the same revision progression.
+ * @type {Map<string, { revision: string; data: { jobId: string; state: string; percent: number } }>}
+ */
+const jobs = new Map([
+  ["local/job_1", { revision: "1", data: { jobId: "job_1", state: "queued", percent: 0 } }]
+]);
+
+/** @type {import("@streamotter/gateway").HandlerRegistry<any>} */
+export const handlers = {
+  async authenticate({ token }) {
+    // TODO: verify your application's session token and return its Principal
+    // ({ subject, tenantId, sessionId, expiresAt, claims }), or null to reject it.
+    // Workbench previews use short-lived preview tokens resolved by the gateway itself,
+    // so this scaffold intentionally accepts no application tokens yet.
+    void token;
+    return null;
+  },
+  channels: {
+    jobProgress: {
+      async authorize({ principal, params }) {
+        return jobs.has(\`\${principal.tenantId}/\${params.jobId}\`);
+      },
+      map({ record }) {
+        const value = /** @type {{ tenantId: string; revision: string; job: { jobId: string; state: string; percent: number } }} */ (record.value);
+        // Development only: keep the in-memory read model in step with the fixture stream.
+        const key = \`\${value.tenantId}/\${value.job.jobId}\`;
+        const current = jobs.get(key);
+        if (current === undefined || BigInt(value.revision) > BigInt(current.revision)) {
+          jobs.set(key, { revision: value.revision, data: value.job });
+        }
+        return [{ tenantId: value.tenantId, params: { jobId: value.job.jobId }, revision: value.revision, data: value.job }];
+      },
+      async snapshot({ principal, params }) {
+        const job = jobs.get(\`\${principal.tenantId}/\${params.jobId}\`);
+        if (job === undefined) throw new Error("Unknown job");
+        return { revision: job.revision, data: job.data };
+      }
+    }
+  }
+};
+
+/** Development-only principals and fixture records. Never used by \`streamotter start\`. */
+export const development = {
+  principals: {
+    developer: { subject: "developer", tenantId: "local", sessionId: "dev-session", expiresAt: "2099-01-01T00:00:00.000Z", claims: {} }
+  },
+  fixtures: {
+    jobs: [
+      { key: "job_1", value: { tenantId: "local", revision: "2", job: { jobId: "job_1", state: "running", percent: 25 } } },
+      { key: "job_1", value: { tenantId: "local", revision: "3", job: { jobId: "job_1", state: "running", percent: 60 } } },
+      { key: "job_1", value: { tenantId: "local", revision: "4", job: { jobId: "job_1", state: "running", percent: 90 } } },
+      { key: "job_1", value: { tenantId: "local", revision: "5", job: { jobId: "job_1", state: "succeeded", percent: 100 } } }
+    ]
+  }
+};
+`;
+    const example = `import { createClient } from "@streamotter/client";
+import { channelVersions, type AppChannels } from "../generated/streamotter.generated.js";
+
+/**
+ * Renders one job's live progress. Run \`streamotter generate --config streamotter.json --out generated\`
+ * first. getToken must return your application's session token (or, during local development,
+ * a preview token from the workbench).
+ */
+export async function watchJob(jobId: string, getToken: () => Promise<string>, element: HTMLElement): Promise<() => Promise<void>> {
+  const client = createClient<AppChannels>({ origin: "http://localhost:7400", getToken: () => getToken() });
+  const job = client.subscribe("jobProgress", { channelVersion: channelVersions.jobProgress, params: { jobId } });
+  job.on("data", ({ data, revision }) => {
+    element.textContent = \`\${data.state} — \${data.percent}% (revision \${revision})\`;
+  });
+  job.on("state", ({ state }) => {
+    element.dataset["delivery"] = state; // "live" means synchronized; anything else may be stale.
+  });
+  job.on("error", error => console.warn(\`[\${error.code}] \${error.message}\`));
+  await job.ready();
+  return async () => {
+    await job.unsubscribe();
+    await client.close();
+  };
+}
+`;
+    const readme = `# ${projectId}
+
+A StreamOtter V1 project created by \`streamotter init\`. It uses a deterministic fixture source,
+so no Kafka broker is needed to start.
+
+## Run locally
+
+\`\`\`bash
+streamotter validate --config streamotter.json
+streamotter dev --config streamotter.json --handlers server/handlers.mjs
+\`\`\`
+
+\`dev\` prints the workbench URL and a one-time management token. In the workbench, create a
+preview session for the \`developer\` principal, subscribe to \`jobProgress\` with \`{"jobId": "job_1"}\`,
+and advance the \`jobs\` fixture to watch revisions arrive.
+
+## Integrate
+
+\`\`\`bash
+streamotter generate --config streamotter.json --out generated
+\`\`\`
+
+\`generated/streamotter.generated.ts\` contains \`AppChannels\`; \`web/example.ts\` shows a subscription
+with cleanup and error handling.
+
+## Before production
+
+- Implement \`authenticate\` in \`server/handlers.mjs\` with your real session verification.
+- Replace the in-memory read model with your authoritative store.
+- Replace the fixture source with a Kafka source using TLS; \`streamotter start\` rejects fixtures and plaintext Kafka.
+`;
+    return [
+        { path: "streamotter.json", content: `${JSON.stringify(config, null, 2)}\n` },
+        { path: "server/handlers.mjs", content: handlers },
+        { path: "web/example.ts", content: example },
+        { path: "README.md", content: readme }
+    ];
+}
+//# sourceMappingURL=templates.js.map

package/dist/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../src/templates.ts"],"names":[],"mappings":"AAAA,2GAA2G;AAC3G,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,MAAM,MAAM,GAAG;QACb,aAAa,EAAE,CAAC;QAChB,SAAS;QACT,OAAO,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,wBAAwB,EAAE,cAAc,EAAE,CAAC,uBAAuB,CAAC,EAAE;QACrH,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE;QACxF,OAAO,EAAE;YACP,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,OAAO,CAAC;gBAChE,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE;aACvE;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC;gBACpF,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;oBACtD,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE;oBAC7E,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE;iBACvD;aACF;SACF;QACD,QAAQ,EAAE;YACR,WAAW,EAAE;gBACX,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa;gBACnF,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE;aAC5E;SACF;KACF,CAAC;IAEF,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkElB,CAAC;IAEA,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBjB,CAAC;IAEA,MAAM,MAAM,GAAG,KAAK,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8B9B,CAAC;IAEA,OAAO;QACL,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAC7E,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,QAAQ,EAAE;QAClD,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,EAAE;QAC5C,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE;KACvC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@streamotter/cli",
+  "version": "0.1.0-rc.1",
+  "description": "StreamOtter command-line interface: init, validate, generate, dev (with the local workbench), and start.",
+  "keywords": [
+    "streamotter",
+    "kafka",
+    "socket.io",
+    "realtime",
+    "live-data",
+    "state-sync",
+    "cli",
+    "codegen",
+    "typescript"
+  ],
+  "homepage": "https://github.com/jfricano/StreamOtter/tree/main/packages/cli#readme",
+  "bugs": {
+    "url": "https://github.com/jfricano/StreamOtter/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jfricano/StreamOtter.git",
+    "directory": "packages/cli"
+  },
+  "license": "MIT",
+  "author": "Orca Solutions",
+  "type": "module",
+  "bin": {
+    "streamotter": "./bin/streamotter.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "bin",
+    "dist",
+    "src"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@streamotter/contracts": "0.1.0-rc.1",
+    "@streamotter/gateway": "0.1.0-rc.1",
+    "@streamotter/workbench": "0.1.0-rc.1"
+  },
+  "devDependencies": {
+    "@types/node": "24.13.6"
+  }
+}