@mistweaverco/kulala-core 0.1.6 → 0.18.1

package/dist/install-backend.js

@@ -0,0 +1,202 @@
+// src/postinstall.ts
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+
+// src/lib/downloader/index.ts
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { chmodSync, createWriteStream } from "node:fs";
+import { pipeline } from "node:stream/promises";
+
+// src/versions/backend.ts
+var KULALA_CORE_VERSION = "0.18.1";
+
+// src/lib/downloader/index.ts
+var PACKAGE_ROOT = path.dirname(fileURLToPath(import.meta.url));
+var BINARY_NAME = "kulala-core";
+var DOWNLOAD_URL = "https://github.com/mistweaverco/kulala-core/releases/download/v%s/%s";
+function platform() {
+  const os = process.platform === "darwin" ? "darwin" : process.platform === "win32" ? "windows" : "linux";
+  const arch = process.arch;
+  let archName = arch;
+  if (arch === "x64") {
+    archName = "x86_64";
+  } else if (arch === "arm64") {
+    archName = os === "darwin" ? "arm64" : "aarch64";
+  }
+  return `${os}-${archName}`;
+}
+function getBinDir() {
+  return path.join(PACKAGE_ROOT, "bin");
+}
+function getReleaseBinName() {
+  const name = `${BINARY_NAME}-${platform()}`;
+  return process.platform === "win32" ? `${name}.exe` : name;
+}
+function getBinName() {
+  return process.platform === "win32" ? `${BINARY_NAME}.exe` : BINARY_NAME;
+}
+function getBinPath() {
+  return path.join(getBinDir(), getBinName());
+}
+function getVersionPath() {
+  return path.join(getBinDir(), "version.txt");
+}
+function getLocalDevBinaryPath() {
+  const candidates = [
+    path.join(PACKAGE_ROOT, "..", "core", "dist", "kulala-core"),
+    path.join(PACKAGE_ROOT, "..", "..", "core", "dist", "kulala-core")
+  ];
+  for (const candidate of candidates) {
+    if (fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  return null;
+}
+function binaryExists() {
+  return fs.existsSync(getBinPath());
+}
+function getInstalledVersion() {
+  const versionPath = getVersionPath();
+  if (!fs.existsSync(versionPath)) {
+    return null;
+  }
+  return fs.readFileSync(versionPath, "utf-8").trim();
+}
+function versionMatches() {
+  const installed = getInstalledVersion();
+  return installed === KULALA_CORE_VERSION;
+}
+function makeExecutable(filePath) {
+  if (process.platform !== "win32") {
+    chmodSync(filePath, 493);
+  }
+}
+var SPINNER_FRAMES = [
+  "⠋",
+  "⠙",
+  "⠹",
+  "⠸",
+  "⠼",
+  "⠴",
+  "⠦",
+  "⠧",
+  "⠇",
+  "⠏"
+];
+function isInteractiveTerminal() {
+  return process.stderr.isTTY === true;
+}
+function createDownloadProgress() {
+  let timer;
+  let frame = 0;
+  let message = "";
+  const clearLine = () => {
+    if (timer) {
+      clearInterval(timer);
+      timer = undefined;
+    }
+    if (isInteractiveTerminal()) {
+      process.stderr.write("\r\x1B[K");
+    }
+  };
+  return {
+    start(msg) {
+      message = msg;
+      if (!isInteractiveTerminal()) {
+        console.error(message);
+        return;
+      }
+      const render = () => {
+        process.stderr.write(`\r${SPINNER_FRAMES[frame]} ${message}`);
+        frame = (frame + 1) % SPINNER_FRAMES.length;
+      };
+      render();
+      timer = setInterval(render, 80);
+    },
+    succeed(msg) {
+      clearLine();
+      console.error(msg);
+    },
+    fail() {
+      clearLine();
+    }
+  };
+}
+async function downloadFile(url, outputPath) {
+  const response = await fetch(url);
+  if (!response.ok || !response.body) {
+    throw new Error(`Failed to download kulala-core from ${url}: ${response.status} ${response.statusText}`);
+  }
+  await pipeline(response.body, createWriteStream(outputPath));
+}
+function removeStaleBinary() {
+  if (!binaryExists()) {
+    return;
+  }
+  fs.unlinkSync(getBinPath());
+  const versionPath = getVersionPath();
+  if (fs.existsSync(versionPath)) {
+    fs.unlinkSync(versionPath);
+  }
+}
+async function installBackend() {
+  const binDir = getBinDir();
+  fs.mkdirSync(binDir, { recursive: true });
+  const releaseName = getReleaseBinName();
+  const url = DOWNLOAD_URL.replace("%s", KULALA_CORE_VERSION).replace("%s", releaseName);
+  const downloadPath = path.join(binDir, `${releaseName}.download`);
+  const binPath = getBinPath();
+  const progress = createDownloadProgress();
+  progress.start(`Downloading kulala-core v${KULALA_CORE_VERSION}...`);
+  try {
+    await downloadFile(url, downloadPath);
+    makeExecutable(downloadPath);
+    fs.renameSync(downloadPath, binPath);
+    fs.writeFileSync(getVersionPath(), KULALA_CORE_VERSION, "utf-8");
+    progress.succeed(`Installed kulala-core to ${binPath}`);
+  } catch (error) {
+    progress.fail();
+    throw error;
+  }
+}
+async function tryInstallBackend() {
+  const fromEnv = process.env.KULALA_CORE_PATH;
+  if (fromEnv && fromEnv.length > 0) {
+    return;
+  }
+  if (getLocalDevBinaryPath()) {
+    return;
+  }
+  if (binaryExists() && versionMatches()) {
+    return;
+  }
+  if (binaryExists()) {
+    removeStaleBinary();
+  }
+  try {
+    await installBackend();
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`Warning: failed to download kulala-core during install: ${message}`);
+    console.error("@mistweaverco/kulala-core will attempt to download it on first use instead.");
+  }
+}
+
+// src/postinstall.ts
+var packageRoot = join(dirname(fileURLToPath2(import.meta.url)), "..");
+if (existsSync(join(packageRoot, "scripts", "build.ts"))) {
+  process.exit(0);
+}
+try {
+  await tryInstallBackend();
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  process.stderr.write(`Warning: kulala-core postinstall failed: ${message}
+`);
+  process.stderr.write(`@mistweaverco/kulala-core will attempt to download it on first use instead.
+`);
+}

package/dist/lib/downloader/index.d.ts

@@ -0,0 +1,15 @@
+declare function getBinPath(): string;
+export declare function installBackend(): Promise<void>;
+/**
+ * Best-effort install for lifecycle scripts (postinstall/prepare).
+ * Never throws; logs a warning when download fails so first-use fallback can run.
+ */
+export declare function tryInstallBackend(): Promise<void>;
+export declare function ensureInstalled(): Promise<string>;
+export declare const downloader: {
+    ensureInstalled: typeof ensureInstalled;
+    getBinPath: typeof getBinPath;
+    installBackend: typeof installBackend;
+    tryInstallBackend: typeof tryInstallBackend;
+};
+export {};

package/dist/lib/kulala-core/index.d.ts

@@ -0,0 +1,17 @@
+import type { KulalaDocument, KulalaFormatInput, KulalaHttpFormatResult, KulalaParseInput, KulalaResponseWrapper, KulalaRunInput } from "./types";
+export type { KulalaDocument, KulalaFormatInput, KulalaHttpFormatResult, KulalaParseInput, KulalaRequestErrorResponse, KulalaRequestSuccessResponse, KulalaResponseItem, KulalaResponseWrapper, KulalaRunInput, RunLimit, } from "./types";
+export type InvokeOptions = {
+    cwd?: string;
+};
+export declare function parseDocument(input: KulalaParseInput, options?: InvokeOptions): Promise<KulalaDocument>;
+export declare function formatDocument(input: KulalaFormatInput, options?: InvokeOptions): Promise<KulalaHttpFormatResult>;
+export declare function runDocument(input: KulalaRunInput, options?: InvokeOptions): Promise<{
+    doc: KulalaDocument;
+    response: KulalaResponseWrapper;
+}>;
+export declare const kulalaCore: {
+    parse: typeof parseDocument;
+    validate: typeof parseDocument;
+    format: typeof formatDocument;
+    run: typeof runDocument;
+};

package/dist/lib/kulala-core/types.d.ts

@@ -0,0 +1,142 @@
+export type KulalaResponseBody = {
+    type: "text";
+    content: string;
+    mediaType?: string;
+} | {
+    type: "json";
+    content: Record<string, unknown>;
+    formatted?: string;
+};
+export type KulalaScriptConsoleLine = {
+    level: "log" | "error" | "warn" | "info" | "debug";
+    message: string;
+    origin: {
+        type: string;
+        name?: string;
+        line?: number;
+    };
+};
+export type KulalaRequestSuccessResponse = {
+    success: true;
+    blockName?: string;
+    status: number;
+    headers: Record<string, string>;
+    url: string;
+    request?: {
+        method: string;
+        url: string;
+        headers?: Record<string, string>;
+        body?: string;
+    };
+    timings: {
+        dns: number;
+        tcp: number;
+        tls: number;
+        request: number;
+        redirect: number;
+        firstByte: number;
+        startTransfer: number;
+        total: number;
+    };
+    body: KulalaResponseBody;
+    filteredBody?: KulalaResponseBody;
+    scriptConsole?: KulalaScriptConsoleLine[];
+};
+export type KulalaRequestErrorResponse = {
+    success: false;
+    blockName?: string;
+    error: string;
+    scriptConsole?: KulalaScriptConsoleLine[];
+    httpCompleted?: boolean;
+    status?: number;
+    headers?: Record<string, string>;
+    url?: string;
+    request?: {
+        method: string;
+        url: string;
+        headers?: Record<string, string>;
+        body?: string;
+    };
+    body?: KulalaResponseBody;
+};
+export type KulalaPromptResponse = {
+    success: false;
+    prompt: true;
+    promptId: string;
+    promptType: string;
+    message: string;
+    inputs: Array<{
+        id: string;
+        label: string;
+        type: "text" | "password" | "url";
+        required?: boolean;
+    }>;
+};
+export type KulalaSkippedResponse = {
+    success: true;
+    skipped: true;
+    blockName?: string;
+    scriptConsole?: KulalaScriptConsoleLine[];
+};
+export type KulalaWebSocketPlanResponse = {
+    success: true;
+    protocol: "websocket";
+    url: string;
+    initialMessage?: string;
+};
+export type KulalaResponseItem = KulalaRequestSuccessResponse | KulalaRequestErrorResponse | KulalaPromptResponse | KulalaSkippedResponse | KulalaWebSocketPlanResponse;
+export type KulalaResponseWrapper = {
+    type: "responses";
+    data: KulalaResponseItem[];
+} | {
+    type: "error";
+    data: KulalaRequestErrorResponse[];
+};
+export type RunLimit = {
+    filter: "name";
+    name: string;
+} | {
+    filter: "cursorPosition";
+    line: number;
+    column: number;
+};
+export type KulalaDocument = {
+    hasErrors: boolean;
+    blocks: Array<{
+        name: string;
+        errors?: Array<{
+            message: string;
+            lineNumber?: number;
+        }>;
+    }>;
+    [key: string]: unknown;
+};
+export type KulalaHttpFormatResult = {
+    content: string;
+    changed: boolean;
+};
+export type KulalaRunInput = {
+    content: string;
+    filepath?: string;
+    env?: string;
+    limit?: RunLimit[];
+    haltOnError?: boolean;
+};
+export type KulalaParseInput = {
+    content: string;
+    filepath?: string;
+};
+export type KulalaFormatInput = {
+    content: string;
+    filepath?: string;
+    formatBody?: boolean;
+    bodyFormat?: {
+        indent?: number;
+        line_width?: number;
+        expand_tabs?: boolean;
+    };
+    defaults?: {
+        http_method?: string;
+        http_version?: string | false;
+    };
+};

package/package.json

@@ -1,22 +1,24 @@
 {
   "name": "@mistweaverco/kulala-core",
-  "version": "0.1.6",
+  "version": "0.18.1",
   "type": "module",
-  "private": false,
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/mistweaverco/kulala-core.git"
+    "url": "git+https://github.com/mistweaverco/kulala-core.git",
+    "directory": "packages/core-npm-wrapper"
   },
   "homepage": "https://github.com/mistweaverco/kulala-core#readme",
   "bugs": {
     "url": "https://github.com/mistweaverco/kulala-core/issues"
   },
   "engines": {
-    "bun": ">=1.0.0"
+    "node": ">=20"
+  },
+  "bin": {
+    "kulala-core": "dist/cli.js"
   },
   "main": "./dist/index.js",
-  "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
@@ -25,25 +27,16 @@
     }
   },
   "files": [
-    "dist",
-    "scripts",
-    "README.md",
-    "LICENSE"
+    "dist/cli.js",
+    "dist/index.js",
+    "dist/index.d.ts",
+    "dist/install-backend.js",
+    "dist/lib"
   ],
   "scripts": {
-    "format": "prettier --write .",
-    "lint": "prettier --check . && eslint .",
-    "test": "bun test",
-    "postinstall": "bun run ./scripts/ensure-vendored-curl.ts",
-    "build": "bun run build:js && bun run build:types",
-    "build:js": "bun build src/index.ts --outdir dist --format esm --target bun --sourcemap --define __KULALA_EMBED_CURL__=false",
-    "build:types": "tsc -p tsconfig.build.json",
-    "prepack": "cp ./../../README.md . && cp ./../../LICENSE . && bun run build"
-  },
-  "pkg": {
-    "assets": [
-      "../../vendor/curl/**/*"
-    ]
+    "build": "bun run scripts/build.ts",
+    "prepare": "bun run scripts/build.ts || true",
+    "postinstall": "node dist/install-backend.js || true"
   },
   "publishConfig": {
     "access": "public"

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025+ mistweaverco
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

package/README.md

@@ -1,84 +0,0 @@
-<div align="center">
-
-![Kulala Logo](assets/logo.svg)
-
-# Kulala Core
-
-[![Made with love](assets/badge-made-with-love.svg)](https://github.com/mistweaverco/kulala-core/graphs/contributors)
-[![GitHub release (latest by date)](https://img.shields.io/github/v/release/mistweaverco/kulala-core?style=for-the-badge)](https://github.com/mistweaverco/kulala-core/releases/latest)
-[![Development status)](assets/badge-development-status.svg)](https://github.com/orgs/mistweaverco/projects/3/views/1?filterQuery=repo%3Amistweaverco%2Fkulala-core)
-[![Discord](assets/badge-discord.svg)](https://discord.gg/QyVQmfY4Rt)
-
-<p></p>
-
-Kulala is swahili for "rest" or "relax."
-
-A straightforwarded, powerful, and extendable HTTP client library.
-It powers the [Kulala toolchain](https://getkulala.net),
-and can be used as a standalone library.
-
-<p></p>
-
-</div>
-
-## Overview
-
-A RESTful API is a web service architecture that adheres to
-specific constraints:
-
-- statelessness,
-- uniform interface,
-- client-server separation
-
-Typically using HTTP methods like `GET`, `POST`, `PUT`, and `DELETE`.
-It uses standard web protocols to enable interoperability
-between distributed systems.
-
-## Features
-
-### Request types
-
-- HTTP RESTful (1.0, 1.1, 2, 3)
-- GraphQL (queries, mutations)
-
-### Variables
-
-- Host Environment
-- Document variables
-- Request scoped variables
-- `http-client.env` files
-- Built-in support for [kuba](https://kuba.mwco.app)
-
-### Scripting
-
-Supports JavaScript, Lua, and TypeScript for:
-
-- Pre-request
-- Post-request
-- Conditional
-- Inline
-- External
-
-### Authentication
-
-- Basic
-- Bearer
-- OAuth 2.0
-
-### Automation and testing
-
-Assertions, automated testing and reporting
-is compatible with the IntelliJ HTTP Client:
-
-## Usage
-
-See the [examples][examples]
-directory for usage examples.
-
-### Vendored curl
-
-- **`npm install` / `bun install`**: the `@mistweaverco/kulala-core` package runs `postinstall`, which downloads a pinned static curl for the **installing machine’s** OS and architecture into the user cache (or you can set `KULALA_CURL_PATH` to your own binary).
-- **Published library** (`dist/`): the npm build sets `__KULALA_EMBED_CURL__=false`, so the tarball does **not** embed curl from the machine that ran `npm publish`.
-- **`bun build --compile`** (your app or the examples): run `packages/core/scripts/generate-vendored-curl.ts` (optionally with `--target=bun-…` for cross-compiles), then compile with `--define __KULALA_EMBED_CURL__=true` so the correct curl is embedded for that build. For cross-compilation you must have the matching curl available under the cache path or under `vendor/curl/<platform>-<arch>/` in this repo.
-
-[examples]: https://github.com/mistweaverco/kulala-core/tree/main/examples

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAExE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EACV,0BAA0B,EAC1B,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAKtB,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAChF,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AASzD,eAAO,MAAM,UAAU;;;;;4BAPK;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KAAG,OAAO,CAAC,cAAc,CAAC;+BAHC;QAC1B,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,KAAG,OAAO,CAAC,cAAc,CAAC;0BASN;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,CAAC,EAAE,yBAAyB,EAAE,CAAC;KACrC,KAAG,OAAO,CAAC;QAAE,GAAG,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,qBAAqB,CAAA;KAAE,CAAC;CAwB7D,CAAC"}