@mistweaverco/kulala-core 0.1.5 → 0.18.0

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.5",
+  "version": "0.18.0",
   "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"}