@hs-x/cli 0.1.0 → 0.1.2

package/dist/services/telemetry.js

@@ -0,0 +1,93 @@
+import { FileSystem, Path } from '@effect/platform';
+import { HttpClientRequest } from '@hs-x/types';
+import { Config, Context, Duration, Effect, Layer } from 'effect';
+import { CLI_VERSION } from '../constants.js';
+import { AppPaths } from './app-paths.js';
+import { CliConfig } from './config.js';
+import { CliHttp } from './http.js';
+import { MachineId } from './machine-id.js';
+export class Telemetry extends Context.Tag('cli/Telemetry')() {
+}
+const truthy = (value) => value === '1' || value === 'true' || value === 'yes';
+export const layer = Layer.effect(Telemetry, Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const paths = yield* AppPaths;
+    const http = yield* CliHttp;
+    const machine = yield* MachineId;
+    const config = yield* CliConfig;
+    const env = yield* Config.all({
+        disabled: Config.string('HSX_TELEMETRY_DISABLED').pipe(Config.withDefault('')),
+        optout: Config.string('HSX_TELEMETRY_OPTOUT').pipe(Config.withDefault('')),
+        doNotTrack: Config.string('DO_NOT_TRACK').pipe(Config.withDefault('')),
+        force: Config.string('HSX_TELEMETRY_FORCE').pipe(Config.withDefault('')),
+        url: Config.string('HSX_TELEMETRY_URL').pipe(Config.withDefault('')),
+        noticePath: Config.string('HSX_TELEMETRY_NOTICE_PATH').pipe(Config.withDefault('')),
+    }).pipe(Effect.orDie);
+    // Edge capture of platform facts — the single sanctioned `process` read.
+    const platform = process.platform;
+    const arch = process.arch;
+    const runtime = process.versions.bun ? 'bun' : 'node';
+    const ci = truthy(process.env.CI ?? '');
+    const enabled = (optedOutByFlag, isSourceTreeRun) => {
+        if (optedOutByFlag)
+            return false;
+        if (truthy(env.disabled) || truthy(env.optout) || truthy(env.doNotTrack))
+            return false;
+        if (truthy(env.force))
+            return true;
+        return !isSourceTreeRun;
+    };
+    const endpoint = () => env.url.length > 0
+        ? env.url
+        : new URL('/v1/telemetry/cli', config.controlPlaneUrl).toString();
+    const machineId = machine.get.pipe(Effect.catchAll(() => Effect.succeed(undefined)));
+    const emit = (input) => Effect.gen(function* () {
+        if (!enabled(input.optedOutByFlag, input.isSourceTreeRun))
+            return;
+        const id = yield* machineId;
+        const request = HttpClientRequest.post(endpoint()).pipe(HttpClientRequest.setHeaders({
+            'content-type': 'application/json',
+            accept: 'application/json',
+        }), HttpClientRequest.bodyText(JSON.stringify({
+            schema_version: 1,
+            event: 'cli.command',
+            cli_version: CLI_VERSION,
+            command: input.command,
+            ...(input.subcommand ? { subcommand: input.subcommand } : {}),
+            ...(id ? { machine_id: id } : {}),
+            exit_code: input.exitCode,
+            duration_ms: input.durationMs,
+            mode: input.mode,
+            os: platform,
+            arch,
+            runtime,
+            ci,
+        }), 'application/json'));
+        yield* http.execute(request).pipe(Effect.timeout(Duration.millis(350)));
+    }).pipe(Effect.ignore);
+    const noticeLines = (input) => Effect.gen(function* () {
+        if (input.json)
+            return [];
+        if (!enabled(input.optedOutByFlag, input.isSourceTreeRun))
+            return [];
+        if (['help', '--help', '-h', '--version', '-v'].includes(input.command))
+            return [];
+        const stamp = env.noticePath.length > 0 ? env.noticePath : paths.cachePath('telemetry-notice.stamp');
+        if (yield* fs.exists(stamp))
+            return [];
+        const id = yield* machineId;
+        const lines = [
+            'hs-x sends anonymous usage telemetry (command name, exit code, duration, os/arch, machine_id).',
+            ...(id
+                ? [`Machine id ${id} lets \`hs-x link\` later claim this machine's deploy history.`]
+                : []),
+            'Opt out with --no-telemetry, HSX_TELEMETRY_OPTOUT=1, or DO_NOT_TRACK=1.',
+        ];
+        yield* fs.makeDirectory(path.dirname(stamp), { recursive: true });
+        yield* fs.writeFileString(stamp, 'shown\n');
+        return lines;
+    }).pipe(Effect.orElseSucceed(() => []));
+    return { emit, noticeLines };
+}));
+//# sourceMappingURL=telemetry.js.map

package/dist/services/telemetry.js.map

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

package/dist/services/tenant-state.d.ts

@@ -0,0 +1,85 @@
+import { Schema, schemas } from '@hs-x/types';
+import { Context, Effect, Layer } from 'effect';
+import { type CliError } from '../cli-error.js';
+import { CloudflareKv } from './cloudflare-kv.js';
+type CloudflarePointer = Schema.Schema.Type<typeof schemas.CloudflarePointer>;
+type LocalDeployEntry = Schema.Schema.Type<typeof schemas.LocalDeployEntry>;
+type LocalActiveDeploy = Schema.Schema.Type<typeof schemas.LocalActiveDeploy>;
+type LocalAppRuntimeBinding = Schema.Schema.Type<typeof schemas.LocalAppRuntimeBinding>;
+type LocalOwnerMeta = Schema.Schema.Type<typeof schemas.LocalOwnerMeta>;
+type HubSpotAppId = Schema.Schema.Type<typeof schemas.HubSpotAppId>;
+/**
+ * A tenant state store bound to one project's Cloudflare pointer, backed by a
+ * `CloudflareKvHandle`. Mirrors the original `StateStore` shape from
+ * `state-store.ts` with every method returning an Effect that fails with a
+ * typed `CliError` (KV transport errors propagate; schema decode failures are
+ * mapped to `HSX_E_INTERNAL`).
+ */
+export interface TenantStateStoreHandle {
+    readonly getOwnerMeta: () => Effect.Effect<LocalOwnerMeta | undefined, CliError>;
+    readonly putOwnerMeta: (meta: LocalOwnerMeta) => Effect.Effect<void, CliError>;
+    readonly recordDeploy: (entry: LocalDeployEntry) => Effect.Effect<void, CliError>;
+    readonly getDeploy: (input: {
+        readonly projectId: string;
+        readonly deployId: string;
+    }) => Effect.Effect<LocalDeployEntry | undefined, CliError>;
+    readonly listDeploys: (input: {
+        readonly projectId: string;
+    }) => Effect.Effect<readonly LocalDeployEntry[], CliError>;
+    readonly getActive: (input: {
+        readonly projectId: string;
+        readonly environment: string;
+    }) => Effect.Effect<LocalActiveDeploy | undefined, CliError>;
+    readonly setActive: (active: LocalActiveDeploy) => Effect.Effect<void, CliError>;
+    readonly getBinding: (input: {
+        readonly projectId: string;
+        readonly environment: string;
+        readonly hubSpotAppId: HubSpotAppId;
+    }) => Effect.Effect<LocalAppRuntimeBinding | undefined, CliError>;
+    readonly putBinding: (binding: LocalAppRuntimeBinding) => Effect.Effect<void, CliError>;
+    readonly listOwners: () => Effect.Effect<readonly string[], CliError>;
+    readonly listProjects: () => Effect.Effect<readonly string[], CliError>;
+}
+/** Result of provisioning/binding the `hsx-state` namespace for a pointer. */
+export interface TenantStateContext {
+    readonly pointer: CloudflarePointer;
+    readonly stateStore: TenantStateStoreHandle;
+}
+/** Cloudflare credentials + optional API base URL needed to reach KV. */
+export interface TenantStateCredentials {
+    readonly apiToken: string;
+    readonly accountId: string;
+    readonly baseUrl?: string;
+}
+/**
+ * Tenant KV state as an injectable service. `store` binds a state-store to an
+ * already-resolved pointer + credentials; `ensureNamespace` provisions the
+ * `hsx-state` namespace and returns the namespace id/title so the caller can
+ * persist a pointer. `ensureStore` chains both, caching the resulting context
+ * per (cacheKey, accountId, apiToken, baseUrl) within the process (replacing
+ * the old module-level `Map`). KV access flows through the injected
+ * `CloudflareKv` service — never `createCloudflareKvClient`.
+ */
+export interface TenantStateApi {
+    readonly store: (input: {
+        readonly pointer: CloudflarePointer;
+        readonly credentials: TenantStateCredentials;
+    }) => Effect.Effect<TenantStateStoreHandle, CliError>;
+    readonly ensureNamespace: (input: {
+        readonly credentials: TenantStateCredentials;
+    }) => Effect.Effect<{
+        readonly id: string;
+        readonly title: string;
+    }, CliError>;
+    readonly ensureStore: (input: {
+        readonly cacheKey: string;
+        readonly pointer: CloudflarePointer;
+        readonly credentials: TenantStateCredentials;
+    }) => Effect.Effect<TenantStateContext, CliError>;
+}
+declare const TenantState_base: Context.TagClass<TenantState, "cli/TenantState", TenantStateApi>;
+export declare class TenantState extends TenantState_base {
+}
+export declare const layer: Layer.Layer<TenantState, never, CloudflareKv>;
+export {};
+//# sourceMappingURL=tenant-state.d.ts.map

package/dist/services/tenant-state.d.ts.map

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

package/dist/services/tenant-state.js

@@ -0,0 +1,98 @@
+import { Schema, schemas } from '@hs-x/types';
+import { Context, Effect, Layer, Ref } from 'effect';
+import { cliError } from '../cli-error.js';
+import { CloudflareKv } from './cloudflare-kv.js';
+export class TenantState extends Context.Tag('cli/TenantState')() {
+}
+export const layer = Layer.effect(TenantState, Effect.gen(function* () {
+    const kv = yield* CloudflareKv;
+    // Replaces the module-level `tenantStateStoreCache` Map from tenant-state.ts.
+    const cache = yield* Ref.make(new Map());
+    // Build a KV handle bound to the state namespace for the given pointer.
+    const boundHandle = (input) => kv.make({
+        accountId: input.pointer.cloudflareAccountId,
+        apiToken: input.credentials.apiToken,
+        namespaceId: input.pointer.stateKvNamespaceId,
+        ...(input.credentials.baseUrl ? { baseUrl: input.credentials.baseUrl } : {}),
+    });
+    const buildStore = (handle, ownerId) => {
+        const readDecoded = (key, schema) => Effect.gen(function* () {
+            const raw = yield* handle.get(key);
+            if (raw === undefined)
+                return undefined;
+            return yield* decodeJson(raw, schema);
+        });
+        const writeJson = (key, value) => handle.put(key, JSON.stringify(value));
+        return {
+            getOwnerMeta: () => readDecoded(ownerMetaKey(ownerId), schemas.LocalOwnerMeta),
+            putOwnerMeta: (meta) => writeJson(ownerMetaKey(ownerId), meta),
+            recordDeploy: (entry) => writeJson(deployKey(ownerId, entry.projectId, entry.deployId), entry),
+            getDeploy: (input) => readDecoded(deployKey(ownerId, input.projectId, input.deployId), schemas.LocalDeployEntry),
+            listDeploys: (input) => Effect.gen(function* () {
+                const prefix = `owners/${ownerId}/projects/${input.projectId}/deploys/`;
+                const keys = yield* handle.list(prefix);
+                const entries = yield* Effect.forEach(keys, (key) => readDecoded(key, schemas.LocalDeployEntry), { concurrency: 'unbounded' });
+                return entries
+                    .filter((entry) => entry !== undefined)
+                    .sort((a, b) => (a.createdAt < b.createdAt ? 1 : -1));
+            }),
+            getActive: (input) => readDecoded(activeDeployKey(ownerId, input.projectId, input.environment), schemas.LocalActiveDeploy),
+            setActive: (active) => writeJson(activeDeployKey(ownerId, active.projectId, active.environment), active),
+            getBinding: (input) => readDecoded(bindingKey(ownerId, input.projectId, input.environment, input.hubSpotAppId), schemas.LocalAppRuntimeBinding),
+            putBinding: (binding) => writeJson(bindingKey(ownerId, binding.projectId, binding.environment, String(binding.hubSpotAppId)), binding),
+            listOwners: () => Effect.gen(function* () {
+                const keys = yield* handle.list('owners/');
+                return [...new Set(keys.map((key) => key.split('/')[1]).filter(isPresent))].sort();
+            }),
+            listProjects: () => Effect.gen(function* () {
+                const keys = yield* handle.list(`owners/${ownerId}/projects/`);
+                return [...new Set(keys.map((key) => key.split('/')[3]).filter(isPresent))].sort();
+            }),
+        };
+    };
+    const store = (input) => Effect.map(boundHandle(input), (handle) => buildStore(handle, input.pointer.ownerId));
+    const ensureNamespace = (input) => Effect.gen(function* () {
+        const handle = yield* kv.make({
+            accountId: input.credentials.accountId,
+            apiToken: input.credentials.apiToken,
+            ...(input.credentials.baseUrl ? { baseUrl: input.credentials.baseUrl } : {}),
+        });
+        const namespace = yield* handle.ensureNamespace('hsx-state');
+        return { id: namespace.id, title: namespace.title };
+    });
+    const ensureStore = (input) => Effect.gen(function* () {
+        const cached = (yield* Ref.get(cache)).get(input.cacheKey);
+        if (cached)
+            return cached;
+        const handle = yield* boundHandle(input);
+        const context = {
+            pointer: input.pointer,
+            stateStore: buildStore(handle, input.pointer.ownerId),
+        };
+        yield* Ref.update(cache, (map) => new Map(map).set(input.cacheKey, context));
+        return context;
+    });
+    return { store, ensureNamespace, ensureStore };
+}));
+function decodeJson(raw, schema) {
+    return Effect.try({
+        try: () => Schema.decodeUnknownSync(schema)(JSON.parse(raw)),
+        catch: (cause) => cliError('HSX_E_INTERNAL', `Failed to decode tenant state value: ${String(cause)}`),
+    });
+}
+function isPresent(value) {
+    return value !== undefined && value.length > 0;
+}
+function ownerMetaKey(ownerId) {
+    return `owners/${ownerId}/meta`;
+}
+function activeDeployKey(ownerId, projectId, environment) {
+    return `owners/${ownerId}/projects/${projectId}/active/${environment}`;
+}
+function deployKey(ownerId, projectId, deployId) {
+    return `owners/${ownerId}/projects/${projectId}/deploys/${deployId}`;
+}
+function bindingKey(ownerId, projectId, environment, hubSpotAppId) {
+    return `owners/${ownerId}/projects/${projectId}/bindings/${environment}/${hubSpotAppId}`;
+}
+//# sourceMappingURL=tenant-state.js.map

package/dist/services/tenant-state.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hs-x/cli",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "HS-X CLI — init, validate, connect, dev, deploy, promote, rollback, doctor, sync. Installs the `hs-x` command.",
   "type": "module",
   "bin": {
@@ -23,6 +23,7 @@
     "@hs-x/codegen": "0.1.0",
     "@hs-x/hubspot": "0.1.0",
     "@hs-x/hubspot-cli": "0.1.0",
+    "@hs-x/runtime": "0.1.0",
     "@hs-x/types": "0.1.0",
     "@hs-x/validator": "0.1.0",
     "effect": "^3.10.19"
@@ -34,5 +35,6 @@
     "@hs-x/fixtures": "0.1.0",
     "@types/node": "^25.8.0",
     "@hs-x/control-plane": "0.1.0"
-  }
+  },
+  "license": "Apache-2.0"
 }