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

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
 
-> @supatype/cli@0.1.0-alpha.6 build /home/runner/work/supatype/supatype/packages/cli
+> @supatype/cli@0.1.0-alpha.7 build /home/runner/work/supatype/supatype/packages/cli
 > tsc --project tsconfig.json
 

package/.turbo/turbo-test.log

@@ -1,7 +1,209 @@
 
-> @supatype/cli@0.1.0-alpha.6 test /home/runner/work/supatype/supatype/packages/cli
+> @supatype/cli@0.1.0-alpha.7 test /home/runner/work/supatype/supatype/packages/cli
 > vitest run
 
 
  RUN  v4.0.18 /home/runner/work/supatype/supatype/packages/cli
 
+ ✓ tests/type-extractor.test.ts (13 tests) 79ms
+ ✓ tests/runtime-contract.test.ts (15 tests) 100ms
+stdout | tests/init.test.ts > scaffold() > creates all expected files
+  created  package.json
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+
+stdout | tests/init.test.ts > scaffold() > supatype.config.ts embeds the project name and exports defineConfig
+  created  package.json
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+
+stdout | tests/init.test.ts > scaffold() > package.json includes @supatype/cli and @supatype/types
+  created  package.json
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+
+stdout | tests/init.test.ts > scaffold() > skips package.json when it already exists
+  skipped  package.json (already exists)
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+
+stdout | tests/init.test.ts > scaffold() > supatype.config.ts documents self-host workflow
+  created  package.json
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+
+stdout | tests/init.test.ts > scaffold() > .env contains DATABASE_URL, JWT_SECRET, POSTGRES_USER, POSTGRES_PASSWORD, POSTGRES_DB
+  created  package.json
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+
+stdout | tests/init.test.ts > scaffold() > .env contains ANON_KEY, SERVICE_ROLE_KEY, and SITE_URL placeholders
+  created  package.json
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+
+stdout | tests/init.test.ts > scaffold() > schema/index.ts exports a User model using RFC v2 Model<>
+  created  package.json
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+
+stdout | tests/init.test.ts > scaffold() > .gitignore excludes .env, node_modules, and engine binary
+  created  package.json
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+
+stdout | tests/init.test.ts > scaffold() > seed.ts references the project name
+  created  package.json
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+
+stdout | tests/init.test.ts > scaffold() > different project names produce different config bodies
+  created  package.json
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+  created  package.json
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+
+ ✓ tests/init.test.ts (11 tests) 39ms
+ ✓ tests/pull-utils.test.ts (49 tests) 12ms
+ ✓ tests/config.test.ts (13 tests) 4586ms
+     ✓ loads a valid supatype.config.ts (plain export default, no package imports)  764ms
+     ✓ normalizes shorthand schema string to { path, pg_schema }  501ms
+     ✓ loads a supatype.config.js (plain ESM)  559ms
+     ✓ throws if config is missing the versions section  585ms
+     ✓ prefers supatype.config.ts over supatype.config.js when both exist  557ms
+     ✓ supports optional output field in config  526ms
+     ✓ merges supatype.local.config.ts over base  1081ms
+ ✓ tests/binary-cache-cloud-overrides.test.ts (11 tests) 19ms
+ ✓ tests/cached-artifact-format.test.ts (7 tests) 13ms
+ ✓ tests/tsx-runner.test.ts (7 tests) 2799ms
+       ✓ evaluates a simple expression and returns stdout  390ms
+       ✓ evaluates TypeScript syntax (type annotations)  393ms
+       ✓ can serialize a JSON object to stdout  377ms
+       ✓ returns non-zero exit code on syntax error  379ms
+       ✓ returns non-zero exit code on runtime error  395ms
+       ✓ captures stderr separately from stdout  383ms
+       ✓ runs a .ts file and returns its stdout  477ms
+ ✓ tests/augmentation-generator.test.ts (3 tests) 12ms
+ ✓ tests/ensure-binary.test.ts (2 tests) 7ms
+stdout | tests/app-command.test.ts > supatype app add --static > sets app.mode=static and static_dir in supatype.config.ts
+  created  package.json
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+
+stdout | tests/app-command.test.ts > supatype app add --static > creates the static directory when missing
+  created  package.json
+  created  supatype.config.ts
+  created  schema/index.ts
+  created  .env
+  created  seed.ts
+  created  seeds/.gitkeep
+  created  public/.gitkeep
+  created  .gitignore
+
+ ✓ tests/app-command.test.ts (2 tests) 2030ms
+     ✓ sets app.mode=static and static_dir in supatype.config.ts  1053ms
+     ✓ creates the static directory when missing  976ms
+ ✓ tests/seed-discover.test.ts (2 tests) 18ms
+ ✓ tests/release-pins.test.ts (2 tests) 3ms
+ ✓ tests/migrate-from-v1.test.ts (1 test) 15ms
+ ✓ tests/keys.test.ts (11 tests) 12253ms
+     ✓ exits 0 with --secret  1115ms
+     ✓ outputs ANON_KEY= line  993ms
+     ✓ outputs SERVICE_ROLE_KEY= line  1030ms
+     ✓ ANON_KEY is a valid three-part JWT  1055ms
+     ✓ SERVICE_ROLE_KEY payload has role: service_role  998ms
+     ✓ JWT has exp in the future  1016ms
+     ✓ --exp-years changes the expiry window  2129ms
+     ✓ reads JWT_SECRET from environment variable  934ms
+     ✓ reads JWT_SECRET from .env file  1006ms
+     ✓ exits non-zero when no secret is available  950ms
+     ✓ keys --help shows --secret and --exp-years options  1020ms
+ ✓ tests/pg-spawn-env.test.ts (2 tests) 5ms
+ ✓ tests/postgres-archive-tag.test.ts (1 test) 2ms
+ ✓ tests/cli-help.test.ts (13 tests) 12560ms
+     ✓ --help lists all top-level commands  973ms
+     ✓ --version prints a semver string  980ms
+     ✓ self-update --help describes the command  1043ms
+     ✓ init --help describes the init command  992ms
+     ✓ push --help describes the push command and --yes flag  987ms
+     ✓ diff --help describes the diff command  1018ms
+     ✓ pull --help describes deprecated pull command  979ms
+     ✓ reset --help shows --yes flag  991ms
+     ✓ app --help describes the app command with add/remove subcommands  1029ms
+     ✓ app add --help shows --static and --port options  969ms
+     ✓ self-host --help shows compose only (legacy commands hidden)  1021ms
+     ✓ self-host compose --help shows compose subcommands  886ms
+     ✓ unknown command exits non-zero  686ms
+
+ Test Files  18 passed (18)
+      Tests  165 passed (165)
+   Start at  21:02:06
+   Duration  15.85s (transform 2.36s, setup 0ms, import 7.59s, tests 34.55s, environment 3ms)
+

package/.turbo/turbo-typecheck.log

@@ -1,4 +1,4 @@
 
-> @supatype/cli@0.1.0-alpha.6 typecheck /home/runner/work/supatype/supatype/packages/cli
+> @supatype/cli@0.1.0-alpha.7 typecheck /home/runner/work/supatype/supatype/packages/cli
 > tsc --project tsconfig.json --noEmit
 

package/dist/app-config.d.ts

@@ -0,0 +1,7 @@
+export interface UpdateAppConfigInput {
+    mode: "none" | "static" | "proxy";
+    staticDir?: string;
+    upstream?: string;
+}
+export declare function updateAppConfigInProject(cwd: string, input: UpdateAppConfigInput): string;
+//# sourceMappingURL=app-config.d.ts.map

package/dist/app-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-config.d.ts","sourceRoot":"","sources":["../src/app-config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAA;IACjC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAQzF"}

package/dist/app-config.js

@@ -0,0 +1,113 @@
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import { Node, Project, QuoteKind, SyntaxKind } from "ts-morph";
+export function updateAppConfigInProject(cwd, input) {
+    const configPath = resolve(cwd, "supatype.config.ts");
+    if (!existsSync(configPath)) {
+        throw new Error("supatype.config.ts not found. Run: supatype init");
+    }
+    const next = updateAppConfigAst(configPath, input);
+    writeFileSync(configPath, next, "utf8");
+    return configPath;
+}
+function updateAppConfigAst(configPath, input) {
+    const project = new Project({
+        useInMemoryFileSystem: false,
+        skipAddingFilesFromTsConfig: true,
+        manipulationSettings: {
+            quoteKind: QuoteKind.Double,
+        },
+    });
+    const srcText = readFileSync(configPath, "utf8");
+    const sourceFile = project.createSourceFile(configPath, srcText, { overwrite: true });
+    const rootObject = getRootConfigObject(sourceFile);
+    const appProperty = rootObject.getProperty("app");
+    if (appProperty === undefined) {
+        rootObject.addPropertyAssignment({
+            name: "app",
+            initializer: renderAppInitializer(input),
+        });
+    }
+    else if (Node.isPropertyAssignment(appProperty)) {
+        const init = appProperty.getInitializer();
+        if (init && Node.isObjectLiteralExpression(init)) {
+            patchAppObject(init, input);
+        }
+        else {
+            appProperty.setInitializer(renderAppInitializer(input));
+        }
+    }
+    else {
+        appProperty.remove();
+        rootObject.addPropertyAssignment({
+            name: "app",
+            initializer: renderAppInitializer(input),
+        });
+    }
+    return sourceFile.getFullText();
+}
+function getRootConfigObject(sourceFile) {
+    const exportAssignment = sourceFile.getFirstDescendantByKind(SyntaxKind.ExportAssignment);
+    if (!exportAssignment) {
+        throw new Error("Could not find default export in supatype.config.ts.");
+    }
+    const expr = exportAssignment.getExpression();
+    if (Node.isObjectLiteralExpression(expr)) {
+        return expr;
+    }
+    if (Node.isCallExpression(expr)) {
+        const [firstArg] = expr.getArguments();
+        if (firstArg && Node.isObjectLiteralExpression(firstArg)) {
+            return firstArg;
+        }
+    }
+    throw new Error("supatype.config.ts must export an object literal or defineConfig({...}).");
+}
+function renderAppInitializer(input) {
+    if (input.mode === "proxy") {
+        return `{
+      mode: "proxy",
+      upstream: "${input.upstream ?? "http://localhost:3000"}",
+    }`;
+    }
+    if (input.mode === "static") {
+        return `{
+      mode: "static",
+      static_dir: "${input.staticDir ?? "./dist"}",
+    }`;
+    }
+    return `{
+    mode: "none",
+  }`;
+}
+function patchAppObject(appObj, input) {
+    upsertStringProperty(appObj, "mode", input.mode);
+    if (input.mode === "proxy") {
+        upsertStringProperty(appObj, "upstream", input.upstream ?? "http://localhost:3000");
+        removePropertyIfPresent(appObj, "static_dir");
+        return;
+    }
+    if (input.mode === "static") {
+        upsertStringProperty(appObj, "static_dir", input.staticDir ?? "./dist");
+        removePropertyIfPresent(appObj, "upstream");
+        return;
+    }
+    removePropertyIfPresent(appObj, "upstream");
+    removePropertyIfPresent(appObj, "static_dir");
+}
+function upsertStringProperty(obj, key, value) {
+    const existing = obj.getProperty(key);
+    if (existing && Node.isPropertyAssignment(existing)) {
+        existing.setInitializer(`"${value}"`);
+        return;
+    }
+    if (existing)
+        existing.remove();
+    obj.addPropertyAssignment({ name: key, initializer: `"${value}"` });
+}
+function removePropertyIfPresent(obj, key) {
+    const prop = obj.getProperty(key);
+    if (prop)
+        prop.remove();
+}
+//# sourceMappingURL=app-config.js.map

package/dist/app-config.js.map

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

package/dist/augmentation-generator.d.ts

@@ -0,0 +1,2 @@
+export declare function generateClientAugmentation(ast: unknown): string;
+//# sourceMappingURL=augmentation-generator.d.ts.map

package/dist/augmentation-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"augmentation-generator.d.ts","sourceRoot":"","sources":["../src/augmentation-generator.ts"],"names":[],"mappings":"AASA,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAyB/D"}

package/dist/augmentation-generator.js

@@ -0,0 +1,111 @@
+export function generateClientAugmentation(ast) {
+    const parsed = ast;
+    const models = [...(parsed.models ?? [])].sort((a, b) => a.tableName.localeCompare(b.tableName));
+    const lines = [];
+    lines.push("// Generated by supatype CLI — do not edit manually.");
+    lines.push("");
+    lines.push("declare module \"@supatype/client\" {");
+    lines.push("  interface SupatypeModels {");
+    for (const model of models) {
+        lines.push(`    ${quoteKey(model.tableName)}: {`);
+        lines.push(`      Row: ${generateRowType(model.fields)}`);
+        lines.push(`      Insert: ${generateInsertType(model.fields)}`);
+        lines.push(`      Update: ${generateUpdateType(model.fields)}`);
+        lines.push("    }");
+    }
+    lines.push("  }");
+    lines.push("}");
+    lines.push("");
+    lines.push("export {}");
+    lines.push("");
+    return lines.join("\n");
+}
+function generateRowType(fields) {
+    const entries = Object.entries(fields).sort(([a], [b]) => a.localeCompare(b));
+    if (entries.length === 0)
+        return "Record<string, unknown>";
+    const body = entries
+        .map(([name, meta]) => `  ${quoteKey(name)}: ${toTsType(meta)}`)
+        .join("\n");
+    return `{\n${body}\n}`;
+}
+function insertColumnOptionalOnInsert(meta) {
+    return meta["default"] !== undefined || meta["serverGenerated"] === true;
+}
+function generateInsertType(fields) {
+    const entries = Object.entries(fields).sort(([a], [b]) => a.localeCompare(b));
+    if (entries.length === 0)
+        return "Record<string, unknown>";
+    const body = entries
+        .map(([name, meta]) => {
+        const required = meta["required"] === true && !insertColumnOptionalOnInsert(meta);
+        return `  ${quoteKey(name)}${required ? "" : "?"}: ${toTsType(meta)}`;
+    })
+        .join("\n");
+    return `{\n${body}\n}`;
+}
+function generateUpdateType(fields) {
+    const entries = Object.entries(fields).sort(([a], [b]) => a.localeCompare(b));
+    if (entries.length === 0)
+        return "Record<string, unknown>";
+    const body = entries
+        .map(([name, meta]) => `  ${quoteKey(name)}?: ${toTsType(meta)}`)
+        .join("\n");
+    return `{\n${body}\n}`;
+}
+function toTsType(meta) {
+    const kind = typeof meta["kind"] === "string" ? meta["kind"] : "json";
+    const required = meta["required"] === true;
+    const base = (() => {
+        switch (kind) {
+            case "uuid":
+            case "slug":
+            case "text":
+            case "email":
+            case "url":
+            case "date":
+            case "timestamp":
+            case "datetime":
+            case "money":
+            case "xml":
+            case "interval":
+                return "string";
+            case "integer":
+            case "smallInt":
+            case "serial":
+            case "float":
+            case "decimal":
+                return "number";
+            case "bigSerial":
+            case "bigInt":
+                return "bigint";
+            case "boolean":
+                return "boolean";
+            case "json":
+            case "blocks":
+            case "geo":
+            case "vector":
+            case "relation":
+            case "array":
+            case "image":
+            case "file":
+                return "Record<string, unknown>";
+            case "richText":
+                return "(import(\"@supatype/types/lexical\").SerializedEditorState | string)";
+            case "enum": {
+                const values = Array.isArray(meta["values"]) ? meta["values"] : [];
+                const quoted = values
+                    .filter((v) => typeof v === "string")
+                    .map((v) => JSON.stringify(v));
+                return quoted.length > 0 ? quoted.join(" | ") : "string";
+            }
+            default:
+                return "unknown";
+        }
+    })();
+    return required ? base : `${base} | null`;
+}
+function quoteKey(key) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : JSON.stringify(key);
+}
+//# sourceMappingURL=augmentation-generator.js.map

package/dist/augmentation-generator.js.map

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

package/dist/binary-cache.d.ts

@@ -0,0 +1,89 @@
+/**
+ * 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` 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.
+ */
+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,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,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"}