TypeScript

weather/
├── app.ts             the implementation
├── wasi.d.ts          type declarations for the WASI imports you use
├── wit/
│   └── world.wit      the interface — defines your tools
├── package.json
├── tsconfig.json
├── noorle.yaml        metadata, permissions, credentials
├── build.sh           what `noorle plugin build` runs
├── prepare.sh         what `noorle plugin prepare` runs
├── .env.example
└── dist/
    ├── app.js         tsc output — the componentizer's input
    └── plugin.wasm    build output

package example:weather;

world weather-component {
    import wasi:cli/environment@0.2.7;

    /// Check the current weather for a location
    export check-weather: func(location: string, unit: string) -> string;
}

import { getEnvironment } from "wasi:cli/environment@0.2.7";

export async function checkWeather(location: string, unit: string): Promise<string> {
  const envVars = getEnvironment();
  // ...
  const response = await fetch(requestUrl, {
    headers: { "User-Agent": "Mozilla/5.0 (compatible; noorle/1.0)" },
  });
  return JSON.stringify(result);
}

declare module "wasi:cli/environment@0.2.7" {
  export function getEnvironment(): Array<[string, string]>;
}

declare global {
  function fetch(url: string, options?: RequestInit): Promise<Response>;
}

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ES2022",
    "moduleResolution": "Node",
    "strict": true,
    "outDir": "./dist",
    "rootDir": "./",
    "lib": ["ES2022", "DOM"],
    "types": [],
    "typeRoots": []
  },
  "include": ["*.ts", "*.d.ts"],
  "exclude": ["node_modules", "dist"]
}

schema_version: "1.0"

metadata:
  name: weather
  description: "Weather information plugin using OpenWeatherMap API"
  author: "Noorle Team"
  tags:
    - weather
    - api

permissions:
  network:
    allow:
      - host: "api.openweathermap.org"
  environment:
    allow:
      - key: OPENWEATHER_API_KEY

noorle plugin build

npm install
wkg wit fetch
npm run typecheck        # tsc --noEmit
npm run compile          # tsc  → dist/app.js
npx jco componentize -w wit/ -o dist/plugin.wasm dist/app.js

wasmtime run --wasi http --env OPENWEATHER_API_KEY=your_api_key_here \
  --invoke 'check-weather("Austin", "metric")' dist/plugin.wasm

noorle login
noorle plugin publish