@supatype/cli 0.1.0-alpha.6 → 0.1.0-alpha.8

package/dist/binary-cache.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Binary cache — manages supatype component binaries.
+ *
+ * Components: engine, server, postgres, deno.
+ * Cache root: ~/.supatype/cache/{component}/{version}/
+ * Override path: config.overrides?.{component} (local build path).
+ *
+ * Security model:
+ *   1. Download checksums.sha256 + checksums.sha256.minisig from CDN.
+ *   2. Verify Ed25519 minisign signature on the checksum file using the
+ *      embedded public key (SUPATYPE_RELEASE_PUBLIC_KEY).
+ *   3. Verify SHA256 of the downloaded binary against the signed checksum.
+ *   Both checks are mandatory when SUPATYPE_RELEASE_PUBLIC_KEY is set.
+ */
+import type { SupatypeProjectConfig } from "./project-config.js";
+/**
+ * Set `versions.{engine|server|postgres|deno}: VERSION_PIN_LOCAL` to mean “use `overrides.*` only”
+ * without duplicating the path string (Phase 10.7). Requires the matching `overrides` entry.
+ */
+export declare const VERSION_PIN_LOCAL = "local";
+/** True if `overrides.engine` points at a local engine binary (contributor dev). */
+export declare function hasEngineOverride(config: SupatypeProjectConfig): boolean;
+export declare function hasStudioOverride(config: SupatypeProjectConfig): boolean;
+/** True if `overrides` contains any non-empty string path (contributor local builds). */
+export declare function hasMeaningfulOverrides(config: SupatypeProjectConfig): boolean;
+/** Lines for a startup banner — non-empty override paths only. */
+export declare function describeActiveOverrides(config: SupatypeProjectConfig): string[];
+/**
+ * True when this working tree is associated with a remote Supatype Cloud project:
+ * `project.ref`, `.supatype/cloud.json` (schema deploy link), or `.supatype/linked.json` (functions link).
+ */
+export declare function isLinkedToCloudProject(cwd: string, config: SupatypeProjectConfig): boolean;
+export type { Component, ComponentVersions } from "./components.js";
+export { BINARY_COMPONENTS } from "./components.js";
+import { type Component } from "./components.js";
+export interface PlatformId {
+    os: "linux" | "darwin" | "windows";
+    arch: "amd64" | "arm64";
+}
+/** Postgres CDN archives use PG major in the basename (17.2 → `supatype-pg-17-…`). */
+export declare function postgresArchiveTag(version: string): string;
+export declare function cacheRoot(): string;
+export declare function cachePath(component: Component, version: string): string;
+export declare function cachedBinaryPath(component: Component, version: string, platform: PlatformId): string;
+export declare function currentPlatform(): PlatformId;
+/**
+ * Resolve the binary path for a component.
+ *
+ * Resolution order:
+ * 1. config.overrides?.[component] — local build path (must exist)
+ * 2. Cached binary at ~/.supatype/cache/{component}/{version}/
+ * 3. Throws — caller should call download() first.
+ *
+ * Hard error if any meaningful `overrides` entry is set while the project is linked to cloud
+ * (`project.ref`, `.supatype/cloud.json`, or `.supatype/linked.json`).
+ */
+export declare function resolveBinary(component: Component, config: SupatypeProjectConfig): Promise<string>;
+/**
+ * Download a component binary to the cache.
+ *
+ * Verification order:
+ *   1. Fetch checksums.sha256 + checksums.sha256.minisig from CDN.
+ *   2. If SUPATYPE_RELEASE_PUBLIC_KEY is set: verify minisign signature.
+ *   3. Verify SHA256 of downloaded binary against signed checksum.
+ */
+/** Download if missing or invalid; return cached path for the given platform. */
+export declare function ensureCachedBinary(component: Component, version: string, platform: PlatformId): Promise<string>;
+export declare function download(component: Component, version: string, platform: PlatformId): Promise<string>;
+/** Confirm a downloaded/cached artifact matches the expected CDN format (tests, CI). */
+export declare function validateArtifactFormat(component: Component, filePath: string, platform: PlatformId): void;
+/**
+ * On Windows, Git Bash represents paths as /c/Users/... — convert to C:\Users\...
+ */
+export declare function normalisePlatformPath(p: string): string;
+export declare function versionFor(component: Component, config: SupatypeProjectConfig): string;
+/**
+ * Fetch the latest available version for a component.
+ * Each component directory on the CDN exposes `latest.json` → `{"version":"x.y.z"}`.
+ */
+export declare function fetchLatestVersion(component: Component): Promise<string>;
+/** Fetch the latest version for all components concurrently. */
+export declare function fetchAllLatestVersions(): Promise<Record<Component, string>>;
+/**
+ * Download all component binaries for the current platform.
+ * Skips components that are already cached.
+ * Fails gracefully when graceful=true (suitable for postinstall).
+ */
+/**
+ * Verify all cached binaries for the current platform (used by integration CI).
+ * Throws if any cached component is missing or fails format checks.
+ */
+export declare function verifyCachedBinaries(versions: SupatypeProjectConfig["versions"]): void;
+export declare function downloadAll(versions: SupatypeProjectConfig["versions"], graceful?: boolean): Promise<void>;
+//# sourceMappingURL=binary-cache.d.ts.map

package/dist/binary-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary-cache.d.ts","sourceRoot":"","sources":["../src/binary-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAmBH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAGhE;;;GAGG;AACH,eAAO,MAAM,iBAAiB,UAAU,CAAA;AAExC,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAGxE;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAGxE;AAED,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAO7E;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAgB/E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAqB1F;AAMD,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAqB,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEnE,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAA;IAClC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;CACxB;AAQD,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AA6BD,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,MAAM,CAEpG;AAgBD,wBAAgB,eAAe,IAAI,UAAU,CAY5C;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,MAAM,CAAC,CA+DjB;AAMD;;;;;;;GAOG;AACH,iFAAiF;AACjF,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,UAAU,GACnB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,UAAU,GACnB,OAAO,CAAC,MAAM,CAAC,CAwDjB;AAmMD,wFAAwF;AACxF,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,UAAU,GACnB,IAAI,CAEN;AAsJD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAYvD;AAED,wBAAgB,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,qBAAqB,GAAG,MAAM,CAMtF;AAMD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAW9E;AAED,gEAAgE;AAChE,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAKjF;AAMD;;;;GAIG;AACH;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,GAAG,IAAI,CAetF;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,qBAAqB,CAAC,UAAU,CAAC,EAC3C,QAAQ,UAAQ,GACf,OAAO,CAAC,IAAI,CAAC,CAmBf"}