@adaptive-ds/zitadel-cli 0.1.0

package/LICENSE

@@ -0,0 +1,22 @@
+
+MIT License
+
+Copyright (c) 2026 David Siewert
+
+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

@@ -0,0 +1,304 @@
+# @adaptive-ds/zitadel-cli
+
+Typed ZITADEL API client and CLI for stable APIs, OIDC/OAuth protocol operations, and two deliberately
+isolated legacy v1 identity-provider operations.
+
+[![npm](https://img.shields.io/npm/v/%40adaptive-ds%2Fzitadel-cli)](https://www.npmjs.com/package/@adaptive-ds/zitadel-cli)
+[![license](https://img.shields.io/npm/l/%40adaptive-ds%2Fzitadel-cli)](./LICENSE)
+
+## What it supports
+
+The supported API contract is pinned to ZITADEL **v4.17.1**. Use ZITADEL v4.17.1 or newer. Newer instances
+may work when their contracts remain compatible, but a changed API is not automatically added to this package's
+catalog.
+
+The catalog contains non-deprecated stable v2 services for:
+
+- actions
+- applications
+- internal permissions
+- organizations
+- projects
+- users
+
+The package also provides OIDC discovery, OAuth device authorization, token requests, and UserInfo requests.
+`legacy_v1` is a compatibility boundary, not general v1 support: only `AdminService.ListIDPs` and
+`AdminService.AddGoogleProvider` are included. Beta, alpha, deprecated, and other v1 methods are excluded and
+cannot be called through the catalog.
+
+This is a client library and command-line tool, not a ZITADEL server or an interactive login browser. Review
+the official [ZITADEL API reference](https://zitadel.com/docs/reference/api) and the output of `api describe`
+before automating a destructive operation.
+
+## Install
+
+The package requires Node.js 22+ or Bun 1.3+.
+
+```sh
+bun add @adaptive-ds/zitadel-cli @adaptive-ds/result valibot
+# or
+npm install @adaptive-ds/zitadel-cli @adaptive-ds/result valibot
+```
+
+The CLI is included in the package:
+
+```sh
+bunx zitadel-cli --help
+# or, after installing it in a project:
+npx zitadel-cli --help
+```
+
+`@adaptive-ds/result` and `valibot` are peer dependencies for library consumers.
+
+## Credentials and configuration
+
+API and legacy v1 commands use:
+
+```dotenv
+ZITADEL_BASE_URL=https://instance.zitadel.cloud
+ZITADEL_TOKEN=replace-with-a-bearer-token
+```
+
+For every setting, the precedence is explicit CLI flag/library option, then the process environment, then the
+explicitly selected `.env` file passed with `--env-file` or `envFile`. There is **no implicit `.env` loading**.
+For example:
+
+```sh
+zitadel-cli projects list \
+  --request-file ./requests/list-projects.json \
+  --base-url https://instance.zitadel.cloud \
+  --token "$ZITADEL_TOKEN" \
+  --env-file .env.local
+```
+
+The flags win over environment variables; environment variables win over values in `.env.local`. A selected
+env file supports blank lines, `#` comments, optional `export`, quoted values, and inline comments on unquoted
+values. Invalid entries and unclosed quotes are reported as errors. Keep token and client-secret files out of
+source control.
+
+OIDC commands use these recommended names (the `ZITADEL_*` aliases are accepted too):
+
+| Purpose | Recommended variable | Accepted aliases |
+| --- | --- | --- |
+| Issuer | `OIDC_ISSUER` | `ZITADEL_OIDC_ISSUER`, `ZITADEL_BASE_URL` |
+| Client ID | `OIDC_CLIENT_ID` | `ZITADEL_OIDC_CLIENT_ID`, `ZITADEL_CLIENT_ID` |
+| Client secret | `OIDC_CLIENT_SECRET` | `ZITADEL_OIDC_CLIENT_SECRET`, `ZITADEL_CLIENT_SECRET` |
+| Client authentication | `OIDC_CLIENT_AUTH` | `OIDC_CLIENT_AUTHENTICATION`, `ZITADEL_OIDC_CLIENT_AUTH`, `ZITADEL_OIDC_CLIENT_AUTHENTICATION`, `ZITADEL_CLIENT_AUTHENTICATION` |
+| Grant type | `OIDC_GRANT_TYPE` | `ZITADEL_OIDC_GRANT_TYPE` |
+
+Device authorization additionally accepts `OIDC_*`, `ZITADEL_OIDC_*`, and shorter `ZITADEL_*` forms for
+`CLIENT_ID`, `CLIENT_SECRET`, `CLIENT_AUTHENTICATION`, `DEVICE_AUTHORIZATION_ENDPOINT`, `SCOPE`, `RESOURCE`,
+`AUTHORIZATION_DETAILS`, and `PARAMETERS_JSON`. CLI flags still take precedence over all of them.
+
+## JSON and YAML
+
+Commands return pretty JSON by default. Add `--output yaml` to API, endpoint, metadata, discovery, device
+authorization, token, or UserInfo commands. The only supported output formats are `json` and `yaml`.
+
+## An AI-efficient API workflow
+
+Do not guess protobuf fields or duplicate a large request schema in a prompt or shell wrapper. Ask the catalog
+for the smallest useful metadata, inspect the generated request descriptor, then call the method:
+
+```sh
+# 1. Find supported services/methods. Filter early when the catalog is large.
+zitadel-cli api list --api-version v2 --service ProjectService
+
+# 2. Inspect the exact request/response fields and official reference URL.
+zitadel-cli api describe ProjectService.ListProjects --output yaml
+
+# 3. Send the complete protobuf JSON request, inline or from a file (never both).
+zitadel-cli api call ProjectService.ListProjects \
+  --request-json '{"pagination":{"limit":25}}' \
+  --base-url https://instance.zitadel.cloud \
+  --token "$ZITADEL_TOKEN"
+```
+
+`api describe` accepts a short service/method name or a fully qualified target such as
+`zitadel.project.v2.ProjectService.ListProjects`. Method metadata includes request and response descriptors,
+the official ZITADEL reference URL, API version, and policy metadata. `api call` only invokes catalog-supported
+unary methods. Use `--request-file ./request.json` for repeatable or reviewed requests.
+
+The same guide is available in [`docs/api-discovery.md`](./docs/api-discovery.md).
+
+## CLI groups
+
+Run `zitadel-cli --help` or `zitadel-cli <group> --help` for the complete command tree. The implemented groups
+are:
+
+- `api`: list, describe, and call the policy-filtered catalog.
+- `actions`: targets, executions, execution functions/methods/services, and public keys.
+- `applications`: application lifecycle, keys, and client-secret operations.
+- `internal-permissions`: administrator lifecycle operations.
+- `organizations`: organization lifecycle, domains, validation, and metadata.
+- `projects`: project lifecycle, grants, and roles.
+- `users`: user lifecycle, metadata, IDP links, OTP/TOTP/U2F/passkeys, recovery codes, secrets, keys, personal
+  access tokens, invite codes, and verification operations.
+- `protocol`: discovery, device authorization, token, and UserInfo.
+- `legacy-v1`: the two approved compatibility operations only.
+
+All generated API groups use the same request/configuration pattern:
+
+```sh
+zitadel-cli applications list --request-file ./requests/list-applications.json
+zitadel-cli organizations domains list --request-file ./requests/list-domains.json --output yaml
+zitadel-cli users list --request-file ./requests/list-users.json
+zitadel-cli actions targets list --request-file ./requests/list-targets.json
+```
+
+The request files contain the complete generated protobuf JSON shape. The endpoint-specific Markdown files in
+[`docs/`](./docs/) link to official references and show representative request shapes.
+
+### OIDC and device flow
+
+Discovery is public and validates the issuer and provider metadata:
+
+```sh
+zitadel-cli protocol discovery \
+  --base-url https://instance.zitadel.cloud \
+  --output json > oidc-discovery.json
+```
+
+Device authorization is a separate, non-interactive request. Use the validated
+`device_authorization_endpoint` from the discovery document:
+
+```sh
+DEVICE_AUTHORIZATION_ENDPOINT="$(jq -er '.device_authorization_endpoint' oidc-discovery.json)"
+DEVICE_CODE="$(
+  zitadel-cli protocol device-authorization \
+    --device-authorization-endpoint "$DEVICE_AUTHORIZATION_ENDPOINT" \
+    --client-id "$OIDC_CLIENT_ID" \
+    --scope 'openid profile' \
+    | tee /tmp/zitadel-device.json \
+    | jq -r '.device_code'
+)"
+```
+
+After the user completes verification, exchange the device code in a separate request:
+
+```sh
+zitadel-cli protocol token \
+  --issuer https://instance.zitadel.cloud \
+  --client-id "$OIDC_CLIENT_ID" \
+  --grant-type urn:ietf:params:oauth:grant-type:device_code \
+  --device-code "$DEVICE_CODE"
+```
+
+The device command does not open a browser or poll the token endpoint. `protocol token` performs one token
+request; callers own any retry/polling policy. `protocol userinfo` consumes a discovery JSON/file and a bearer
+token, and uses the validated `userinfo_endpoint` verbatim:
+
+```sh
+zitadel-cli protocol userinfo \
+  --discovery-file ./oidc-discovery.json \
+  --token "$ACCESS_TOKEN"
+```
+
+Use `--client-auth none`, `client_secret_basic`, or `client_secret_post` where appropriate. The token command
+accepts repeated `--field NAME=VALUE` flags for additional OAuth parameters.
+
+### Legacy v1 isolation
+
+The compatibility commands are explicit and namespaced:
+
+```sh
+zitadel-cli legacy-v1 list-idps --request-file ./requests/list-idps.json
+zitadel-cli legacy-v1 add-google-provider --request-file ./requests/add-google-provider.json
+```
+
+They use the generated v1 protobuf shapes but are not mixed into the v2 service exports. Other v1 methods,
+deprecated methods, alpha methods, and beta methods are rejected by the policy-filtered catalog.
+
+## Library
+
+The root export includes catalog/discovery, configuration, JSON/YAML serialization, OIDC/OAuth protocol helpers,
+typed v2 service wrappers, request parsers, generated descriptors, and types. Service-specific entry points are
+also available from `@adaptive-ds/zitadel-cli/v2`, `@adaptive-ds/zitadel-cli/protocol`, and
+`@adaptive-ds/zitadel-cli/legacy_v1`.
+
+Fallible library operations return `Result<T>` or `PromiseResult<T>` from `@adaptive-ds/result`; inspect
+`success` rather than relying on thrown transport or validation errors:
+
+```ts
+import {
+  ListProjectsResponseSchema,
+  messageSerialize,
+  projectServiceListProjects,
+} from "@adaptive-ds/zitadel-cli"
+
+const result = await projectServiceListProjects({
+  baseUrl: process.env.ZITADEL_BASE_URL,
+  token: process.env.ZITADEL_TOKEN,
+  request: { pagination: { limit: 25 } },
+})
+
+if (!result.success) {
+  console.error(`${result.op}: ${result.errorMessage}`)
+  process.exitCode = 1
+} else {
+  const output = messageSerialize(ListProjectsResponseSchema, result.data, "yaml")
+  if (!output.success) {
+    console.error(`${output.op}: ${output.errorMessage}`)
+    process.exitCode = 1
+  } else {
+    console.log(output.data)
+  }
+}
+```
+
+OIDC discovery is also Result-based and validates the provider configuration before returning it:
+
+```ts
+import { oidcDiscovery } from "@adaptive-ds/zitadel-cli"
+
+const discovery = await oidcDiscovery({
+  baseUrl: "https://instance.zitadel.cloud",
+})
+
+if (!discovery.success) {
+  console.error(`${discovery.op}: ${discovery.errorMessage}`)
+} else {
+  console.log(discovery.data.issuer, discovery.data.token_endpoint)
+}
+```
+
+`zitadelConfigCreate`, `apiCall`, `apiCatalogList`, `apiMethodDescribe`, `deviceAuthorizationRequest`,
+`oauthTokenRequest`, and `oidcUserInfo` are exported for composing the same workflows without the CLI. Inject a
+custom `fetch` or Connect transport in library options when tests or a custom runtime need one.
+
+## Generated sources
+
+`src/generated/` is generated from the pinned ZITADEL protobuf tarball in [`buf.gen.yaml`](./buf.gen.yaml).
+Do not hand-edit generated contracts. To intentionally update the contract, change the pinned upstream input,
+run:
+
+```sh
+bun run generate:proto
+```
+
+Then review generated diffs, the policy-filtered catalog, official documentation URLs, and all checks. Generated
+files are excluded from Biome formatting but are required for type checking and builds.
+
+## Development and release
+
+```sh
+bun install
+bun run dev             # run the CLI from source
+bun run generate:proto  # regenerate pinned protobuf/Connect sources
+bun run format          # format source, tests, and configuration
+bun run format:check
+bun run type-check
+bun run test
+bun run test:w
+bun run build           # clean dist/ and emit JS, declarations, and maps
+bun run deploy          # format check, type-check, tests, and build
+```
+
+`bun run release [version]` runs the build, creates a changelog from Git history, updates the package version,
+commits and tags on `main`, pushes the branch and tags, and creates the GitHub release. It requires authenticated
+`gh` and `git cliff`. The release script does not run `npm publish`; publish the package through the repository's
+configured package-publishing workflow after the preflight.
+
+## License
+
+MIT © David Siewert. See [`LICENSE`](./LICENSE).

package/dist/api/apiCall.d.ts

@@ -0,0 +1,18 @@
+import type { DescMessage, MessageInitShape, MessageShape } from "@bufbuild/protobuf";
+import type { Transport } from "@connectrpc/connect";
+import { type PromiseResult } from "#result";
+import type { ZitadelConfig } from "../config/zitadelConfig.js";
+export type ApiCallOptions = {
+    readonly baseUrl?: string;
+    readonly config?: ZitadelConfig;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly envFile?: string;
+    readonly method: string;
+    readonly requestFile?: string;
+    readonly requestJson?: string;
+    readonly request?: MessageInitShape<DescMessage>;
+    readonly token?: string;
+    readonly transport?: Transport;
+};
+export declare function apiCall(options: ApiCallOptions): PromiseResult<MessageShape<DescMessage>>;
+//# sourceMappingURL=apiCall.d.ts.map

package/dist/api/apiCall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiCall.d.ts","sourceRoot":"","sources":["../../src/api/apiCall.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,SAAS,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAK/D,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAA;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,WAAW,CAAC,CAAA;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAC/B,CAAA;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,aAAa,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC,CAoD/F"}

package/dist/api/apiCall.js

@@ -0,0 +1,54 @@
+import { createResultError } from "#result";
+import { endpointCall } from "../v2/internal/endpointCall.js";
+import { endpointRequestParse } from "../v2/internal/endpointRequestParse.js";
+import { apiMethodFind } from "./apiMethodFind.js";
+export async function apiCall(options) {
+    const op = "apiCall";
+    const methodResult = apiMethodFind(options.method);
+    if (!methodResult.success) {
+        return createResultError(op, methodResult.errorMessage);
+    }
+    const catalogMethod = methodResult.data;
+    const methodDescriptor = catalogMethod.service.methods.find(({ localName }) => localName === catalogMethod.methodKey);
+    if (methodDescriptor === undefined) {
+        return createResultError(op, `Catalog method descriptor is missing for "${options.method}"`);
+    }
+    if (methodDescriptor.methodKind !== "unary") {
+        return createResultError(op, `API method "${options.method}" is not a unary method supported by api call`);
+    }
+    if (options.request !== undefined && (options.requestJson !== undefined || options.requestFile !== undefined)) {
+        return createResultError(op, "Use a request object or --request-json/--request-file, not both");
+    }
+    let request = options.request ?? {};
+    if (options.requestJson !== undefined || options.requestFile !== undefined) {
+        const requestResult = await endpointRequestParse({
+            file: options.requestFile,
+            json: options.requestJson,
+            operation: `${op}RequestParse`,
+            schema: catalogMethod.request,
+        });
+        if (!requestResult.success) {
+            return createResultError(op, requestResult.errorMessage);
+        }
+        request = requestResult.data;
+    }
+    return endpointCall({
+        baseUrl: options.baseUrl,
+        config: options.config,
+        env: options.env,
+        envFile: options.envFile,
+        invoke: (client, request) => {
+            const invoke = client[catalogMethod.methodKey];
+            if (typeof invoke !== "function") {
+                return Promise.reject(new Error(`Catalog client method "${catalogMethod.methodKey}" is unavailable`));
+            }
+            return invoke(request);
+        },
+        operation: op,
+        request,
+        service: catalogMethod.service,
+        token: options.token,
+        transport: options.transport,
+    });
+}
+//# sourceMappingURL=apiCall.js.map

package/dist/api/apiCall.js.map

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

package/dist/api/apiCatalogList.d.ts

@@ -0,0 +1,15 @@
+import type { ServiceCatalogEntry } from "../catalog/index.js";
+import { apiPolicy } from "./apiPolicy.js";
+import { type ApiServiceDescription } from "./apiServiceDescribe.js";
+export type ApiCatalogListOptions = {
+    readonly apiVersion?: ServiceCatalogEntry["apiVersion"];
+    readonly service?: string;
+};
+export type ApiCatalogList = {
+    readonly deprecationPolicy: (typeof apiPolicy)["deprecation"];
+    readonly legacyPolicy: (typeof apiPolicy)["legacy"];
+    readonly services: readonly ApiServiceDescription[];
+    readonly versions: (typeof apiPolicy)["versions"];
+};
+export declare function apiCatalogList(options?: ApiCatalogListOptions): ApiCatalogList;
+//# sourceMappingURL=apiCatalogList.d.ts.map

package/dist/api/apiCatalogList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiCatalogList.d.ts","sourceRoot":"","sources":["../../src/api/apiCatalogList.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAA;AAE9D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAsB,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AAExF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAA;IACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,SAAS,CAAC,CAAC,aAAa,CAAC,CAAA;IAC7D,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAA;IACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAA;IACnD,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,CAAC,CAAA;CAClD,CAAA;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,cAAc,CAoBlF"}

package/dist/api/apiCatalogList.js

@@ -0,0 +1,22 @@
+import { SERVICE_CATALOG } from "../catalog/index.js";
+import { apiPolicy } from "./apiPolicy.js";
+import { apiServiceDescribe } from "./apiServiceDescribe.js";
+export function apiCatalogList(options = {}) {
+    const serviceTarget = options.service?.trim().toLowerCase();
+    const services = SERVICE_CATALOG.filter((service) => {
+        if (options.apiVersion !== undefined && service.apiVersion !== options.apiVersion) {
+            return false;
+        }
+        if (serviceTarget === undefined || serviceTarget === "") {
+            return true;
+        }
+        return [service.docsCategory, service.serviceName, service.typeName].some((alias) => alias.toLowerCase() === serviceTarget);
+    }).map(apiServiceDescribe);
+    return {
+        deprecationPolicy: { ...apiPolicy.deprecation },
+        legacyPolicy: { ...apiPolicy.legacy },
+        services,
+        versions: apiPolicy.versions,
+    };
+}
+//# sourceMappingURL=apiCatalogList.js.map

package/dist/api/apiCatalogList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiCatalogList.js","sourceRoot":"","sources":["../../src/api/apiCatalogList.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,kBAAkB,EAA8B,MAAM,yBAAyB,CAAA;AAcxF,MAAM,UAAU,cAAc,CAAC,UAAiC,EAAE;IAChE,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IAC3D,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE;QAClD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;YAClF,OAAO,KAAK,CAAA;QACd,CAAC;QACD,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,KAAK,EAAE,EAAE,CAAC;YACxD,OAAO,IAAI,CAAA;QACb,CAAC;QACD,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,IAAI,CACvE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,aAAa,CACjD,CAAA;IACH,CAAC,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAA;IAE1B,OAAO;QACL,iBAAiB,EAAE,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE;QAC/C,YAAY,EAAE,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE;QACrC,QAAQ;QACR,QAAQ,EAAE,SAAS,CAAC,QAAQ;KAC7B,CAAA;AACH,CAAC"}

package/dist/api/apiMessageDescribe.d.ts

@@ -0,0 +1,19 @@
+import { type DescField, type DescMessage } from "@bufbuild/protobuf";
+export type ApiFieldDescription = {
+    readonly deprecated: boolean;
+    readonly fieldKind: DescField["fieldKind"];
+    readonly jsonName: string;
+    readonly localName: string;
+    readonly name: string;
+    readonly number: number;
+    readonly presence: DescField["presence"];
+    readonly repeated: boolean;
+    readonly typeName: string;
+};
+export type ApiMessageDescription = {
+    readonly fields: readonly ApiFieldDescription[];
+    readonly name: string;
+    readonly typeName: string;
+};
+export declare function apiMessageDescribe(message: DescMessage): ApiMessageDescription;
+//# sourceMappingURL=apiMessageDescribe.d.ts.map

package/dist/api/apiMessageDescribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiMessageDescribe.d.ts","sourceRoot":"","sources":["../../src/api/apiMessageDescribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAEjF,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,WAAW,CAAC,CAAA;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,UAAU,CAAC,CAAA;IACxC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,MAAM,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B,CAAA;AAgCD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,qBAAqB,CAgB9E"}

package/dist/api/apiMessageDescribe.js

@@ -0,0 +1,47 @@
+import { ScalarType } from "@bufbuild/protobuf";
+const scalarTypeNameCreate = (scalar) => ScalarType[scalar];
+const fieldTypeNameCreate = (field) => {
+    if (field.fieldKind === "scalar") {
+        return scalarTypeNameCreate(field.scalar);
+    }
+    if (field.fieldKind === "enum") {
+        return field.enum.typeName;
+    }
+    if (field.fieldKind === "message") {
+        return field.message.typeName;
+    }
+    if (field.fieldKind === "list") {
+        if (field.listKind === "scalar") {
+            return scalarTypeNameCreate(field.scalar);
+        }
+        if (field.listKind === "enum") {
+            return field.enum.typeName;
+        }
+        return field.message.typeName;
+    }
+    if (field.mapKind === "scalar") {
+        return scalarTypeNameCreate(field.scalar);
+    }
+    if (field.mapKind === "enum") {
+        return field.enum.typeName;
+    }
+    return field.message.typeName;
+};
+export function apiMessageDescribe(message) {
+    return {
+        fields: message.fields.map((field) => ({
+            deprecated: field.deprecated,
+            fieldKind: field.fieldKind,
+            jsonName: field.jsonName,
+            localName: field.localName,
+            name: field.name,
+            number: field.number,
+            presence: field.presence,
+            repeated: field.fieldKind === "list",
+            typeName: fieldTypeNameCreate(field),
+        })),
+        name: message.name,
+        typeName: message.typeName,
+    };
+}
+//# sourceMappingURL=apiMessageDescribe.js.map

package/dist/api/apiMessageDescribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiMessageDescribe.js","sourceRoot":"","sources":["../../src/api/apiMessageDescribe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAoC,MAAM,oBAAoB,CAAA;AAoBjF,MAAM,oBAAoB,GAAG,CAAC,MAAkB,EAAE,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;AAEvE,MAAM,mBAAmB,GAAG,CAAC,KAAgB,EAAU,EAAE;IACvD,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC3C,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAA;IAC5B,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAA;IAC/B,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC3C,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAA;QAC5B,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAA;IAC/B,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC3C,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAA;IAC5B,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAA;AAC/B,CAAC,CAAA;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAoB;IACrD,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,KAAK,MAAM;YACpC,QAAQ,EAAE,mBAAmB,CAAC,KAAK,CAAC;SACrC,CAAC,CAAC;QACH,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAA;AACH,CAAC"}

package/dist/api/apiMetadataSerialize.d.ts

@@ -0,0 +1,4 @@
+import { type Result } from "#result";
+export type ApiOutputFormat = "json" | "yaml";
+export declare function apiMetadataSerialize(value: unknown, format?: ApiOutputFormat): Result<string>;
+//# sourceMappingURL=apiMetadataSerialize.d.ts.map

package/dist/api/apiMetadataSerialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiMetadataSerialize.d.ts","sourceRoot":"","sources":["../../src/api/apiMetadataSerialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,MAAM,EAAE,MAAM,SAAS,CAAA;AAGtE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAA;AAE7C,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAE,eAAwB,GAAG,MAAM,CAAC,MAAM,CAAC,CAerG"}

package/dist/api/apiMetadataSerialize.js

@@ -0,0 +1,19 @@
+import { createResult, createResultError } from "#result";
+import { stringify } from "yaml";
+export function apiMetadataSerialize(value, format = "json") {
+    const op = "apiMetadataSerialize";
+    try {
+        if (format === "json") {
+            return createResult(JSON.stringify(value, null, 2));
+        }
+        if (format === "yaml") {
+            return createResult(stringify(value));
+        }
+        return createResultError(op, `Unsupported output format: ${format}`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return createResultError(op, message);
+    }
+}
+//# sourceMappingURL=apiMetadataSerialize.js.map

package/dist/api/apiMetadataSerialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiMetadataSerialize.js","sourceRoot":"","sources":["../../src/api/apiMetadataSerialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAe,MAAM,SAAS,CAAA;AACtE,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AAIhC,MAAM,UAAU,oBAAoB,CAAC,KAAc,EAAE,SAA0B,MAAM;IACnF,MAAM,EAAE,GAAG,sBAAsB,CAAA;IAEjC,IAAI,CAAC;QACH,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;QACrD,CAAC;QACD,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;YACtB,OAAO,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;QACvC,CAAC;QACD,OAAO,iBAAiB,CAAC,EAAE,EAAE,8BAA8B,MAAM,EAAE,CAAC,CAAA;IACtE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QACtE,OAAO,iBAAiB,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;IACvC,CAAC;AACH,CAAC"}

package/dist/api/apiMethodDescribe.d.ts

@@ -0,0 +1,29 @@
+import type { MethodCatalogEntry } from "../catalog/index.js";
+import { type ApiMessageDescription } from "./apiMessageDescribe.js";
+import { apiPolicy } from "./apiPolicy.js";
+export type ApiMethodDescription = {
+    readonly apiVersion: MethodCatalogEntry["apiVersion"];
+    readonly deprecated: false;
+    readonly deprecationPolicy: (typeof apiPolicy)["deprecation"];
+    readonly docs: {
+        readonly url: string;
+    };
+    readonly docsCategory: string;
+    readonly legacyPolicy: (typeof apiPolicy)["legacy"];
+    readonly method: {
+        readonly kind: string;
+        readonly localName: string;
+        readonly name: string;
+    };
+    readonly methodKey: string;
+    readonly methodName: string;
+    readonly request: ApiMessageDescription;
+    readonly response: ApiMessageDescription;
+    readonly service: {
+        readonly name: string;
+        readonly typeName: string;
+    };
+    readonly serviceName: string;
+};
+export declare function apiMethodDescribe(entry: MethodCatalogEntry): ApiMethodDescription;
+//# sourceMappingURL=apiMethodDescribe.d.ts.map

package/dist/api/apiMethodDescribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiMethodDescribe.d.ts","sourceRoot":"","sources":["../../src/api/apiMethodDescribe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAC7D,OAAO,EAAsB,KAAK,qBAAqB,EAAE,MAAM,yBAAyB,CAAA;AACxF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE1C,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAA;IACrD,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAA;IAC1B,QAAQ,CAAC,iBAAiB,EAAE,CAAC,OAAO,SAAS,CAAC,CAAC,aAAa,CAAC,CAAA;IAC7D,QAAQ,CAAC,IAAI,EAAE;QACb,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,CAAC,OAAO,SAAS,CAAC,CAAC,QAAQ,CAAC,CAAA;IACnD,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;QAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KACtB,CAAA;IACD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAA;IACvC,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;KAC1B,CAAA;IACD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAC7B,CAAA;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,oBAAoB,CA2BjF"}

package/dist/api/apiMethodDescribe.js

@@ -0,0 +1,30 @@
+import { apiMessageDescribe } from "./apiMessageDescribe.js";
+import { apiPolicy } from "./apiPolicy.js";
+export function apiMethodDescribe(entry) {
+    const method = entry.service.methods.find(({ localName }) => localName === entry.methodKey);
+    return {
+        apiVersion: entry.apiVersion,
+        deprecated: false,
+        deprecationPolicy: { ...apiPolicy.deprecation },
+        docs: {
+            url: entry.docsUrl,
+        },
+        docsCategory: entry.docsCategory,
+        legacyPolicy: { ...apiPolicy.legacy },
+        method: {
+            kind: method?.methodKind ?? "unknown",
+            localName: entry.methodKey,
+            name: entry.methodName,
+        },
+        methodKey: entry.methodKey,
+        methodName: entry.methodName,
+        request: apiMessageDescribe(entry.request),
+        response: apiMessageDescribe(entry.response),
+        service: {
+            name: entry.service.name,
+            typeName: entry.service.typeName,
+        },
+        serviceName: entry.serviceName,
+    };
+}
+//# sourceMappingURL=apiMethodDescribe.js.map

package/dist/api/apiMethodDescribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiMethodDescribe.js","sourceRoot":"","sources":["../../src/api/apiMethodDescribe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAA8B,MAAM,yBAAyB,CAAA;AACxF,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AA2B1C,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC,CAAA;IAE3F,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,UAAU,EAAE,KAAK;QACjB,iBAAiB,EAAE,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE;QAC/C,IAAI,EAAE;YACJ,GAAG,EAAE,KAAK,CAAC,OAAO;SACnB;QACD,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,YAAY,EAAE,EAAE,GAAG,SAAS,CAAC,MAAM,EAAE;QACrC,MAAM,EAAE;YACN,IAAI,EAAE,MAAM,EAAE,UAAU,IAAI,SAAS;YACrC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,IAAI,EAAE,KAAK,CAAC,UAAU;SACvB;QACD,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,OAAO,EAAE,kBAAkB,CAAC,KAAK,CAAC,OAAO,CAAC;QAC1C,QAAQ,EAAE,kBAAkB,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC5C,OAAO,EAAE;YACP,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI;YACxB,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ;SACjC;QACD,WAAW,EAAE,KAAK,CAAC,WAAW;KAC/B,CAAA;AACH,CAAC"}

package/dist/api/apiMethodFind.d.ts

@@ -0,0 +1,4 @@
+import { type Result } from "#result";
+import { type MethodCatalogEntry } from "../catalog/index.js";
+export declare function apiMethodFind(target: string, catalog?: readonly MethodCatalogEntry[]): Result<MethodCatalogEntry>;
+//# sourceMappingURL=apiMethodFind.d.ts.map

package/dist/api/apiMethodFind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiMethodFind.d.ts","sourceRoot":"","sources":["../../src/api/apiMethodFind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmC,KAAK,MAAM,EAAE,MAAM,SAAS,CAAA;AACtE,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAc7E,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,SAAS,kBAAkB,EAAmB,GACtD,MAAM,CAAC,kBAAkB,CAAC,CAqB5B"}