@kidd-cli/core 0.1.0

package/dist/lib/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","names":[],"sources":["../../src/context/redact.ts","../../src/lib/output/renderer.ts","../../src/lib/output/format.ts","../../src/lib/output/create-output.ts","../../src/lib/output/defaults.ts"],"sourcesContent":["import pinoRedact from '@pinojs/redact'\n\nconst CENSOR = '[REDACTED]'\n\n/**\n * Keys that are always redacted regardless of their depth in the object tree.\n */\nconst SENSITIVE_KEYS: ReadonlySet<string> = new Set([\n  'password',\n  'secret',\n  'token',\n  'apiKey',\n  'api_key',\n  'apiSecret',\n  'api_secret',\n  'authorization',\n  'auth',\n  'credentials',\n  'private_key',\n  'privateKey',\n])\n\n/**\n * Specific nested paths where the key name alone is not sensitive\n * but the location makes it sensitive. Handled by `@pinojs/redact`.\n */\nconst SPECIFIC_PATHS: readonly string[] = [\n  'headers.Authorization',\n  'env.GITHUB_TOKEN',\n  'env.LINEAR_API_KEY',\n]\n\nconst redactPaths = pinoRedact({\n  censor: resolveCensor,\n  paths: [...SPECIFIC_PATHS],\n  serialize: false,\n})\n\n// ---------------------------------------------------------------------------\n// Private helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Censor function for `@pinojs/redact` that preserves null/undefined values.\n *\n * @private\n * @param value - The original value at a redacted path.\n * @returns The censor string or the original null/undefined.\n */\nfunction resolveCensor(value: unknown): unknown {\n  if (value === null || value === undefined) {\n    return value\n  }\n  return CENSOR\n}\n\n/**\n * Deep-clone an object and replace values at sensitive key paths with `[REDACTED]`.\n *\n * Uses `@pinojs/redact` for specific fixed paths and a recursive walk for\n * any-depth key-name matching against {@link SENSITIVE_KEYS}.\n *\n * @param obj - The object to redact.\n * @returns A deep clone with sensitive values replaced.\n */\nexport function redactObject<TObj extends object>(obj: TObj): TObj {\n  const pathRedacted = redactPaths(obj)\n  return redactSensitiveKeys(pathRedacted as Record<string, unknown>) as TObj\n}\n\n/**\n * Recursively walk an object and redact values whose key is in {@link SENSITIVE_KEYS}.\n * Returns a new object — does not mutate the input.\n *\n * @private\n * @param target - The record to walk.\n * @returns A new record with sensitive values replaced.\n */\nfunction redactSensitiveKeys(target: Record<string, unknown>): Record<string, unknown> {\n  return Object.fromEntries(\n    Object.entries(target)\n      .filter(([key]) => key !== 'restore')\n      .map(([key, value]) => redactEntry(key, value))\n  )\n}\n\n/**\n * Process a single key-value entry for sensitive-key redaction.\n *\n * @private\n * @param key - The property key.\n * @param value - The property value.\n * @returns A [key, value] tuple with the value potentially redacted.\n */\nfunction redactEntry(key: string, value: unknown): [string, unknown] {\n  if (SENSITIVE_KEYS.has(key) && value !== undefined && value !== null) {\n    return [key, CENSOR]\n  }\n\n  if (Array.isArray(value)) {\n    return [key, value.map(redactArrayItem)]\n  }\n\n  if (value && typeof value === 'object') {\n    return [key, redactSensitiveKeys(value as Record<string, unknown>)]\n  }\n\n  return [key, value]\n}\n\n/**\n * Redact sensitive keys within an array item if it is an object.\n *\n * @private\n * @param item - The array element.\n * @returns The element with sensitive keys redacted, or the original primitive.\n */\nfunction redactArrayItem(item: unknown): unknown {\n  if (item && typeof item === 'object') {\n    return redactSensitiveKeys(item as Record<string, unknown>)\n  }\n  return item\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\n\nimport { attempt, err, ok } from '@kidd-cli/utils/fp'\nimport type { Result } from '@kidd-cli/utils/fp'\nimport { Liquid } from 'liquidjs'\n\nimport type {\n  CreateRendererOptions,\n  LoadTemplateOptions,\n  Renderer,\n  RenderTemplateOptions,\n  ToMarkdownParams,\n} from './types.js'\n\n/**\n * Resolve an unknown error to a string message.\n *\n * @param error - The error to resolve.\n * @returns A string error message.\n */\nexport function resolveRenderError(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message\n  }\n  return 'Unknown error'\n}\n\n/**\n * Create a Liquid template {@link Renderer}.\n *\n * @param options - Renderer configuration.\n * @returns A Renderer instance.\n */\nexport function createRenderer(options: CreateRendererOptions): Renderer {\n  const { templates: templatesDir, filters = {}, context } = options\n  const liquid = new Liquid()\n  const templateCache = new Map<string, string>()\n\n  for (const [name, fn] of Object.entries(filters)) {\n    liquid.registerFilter(name, fn)\n  }\n\n  return {\n    render(params: ToMarkdownParams): Result<string, Error> {\n      const [templateError, template] = loadTemplateFromDisk({\n        cache: templateCache,\n        templatesDir,\n        type: params.type,\n      })\n      if (templateError) {\n        return [templateError, null]\n      }\n\n      const extraContext = resolveExtraContext(context, params)\n      return renderTemplate({ extraContext, liquid, params, template })\n    },\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Private\n// ---------------------------------------------------------------------------\n\n/**\n * Resolve the full filesystem path to a Liquid template file.\n *\n * @private\n */\nfunction resolveTemplatePath(templatesDir: string, type: string): string {\n  const segments = type.split(':')\n  return `${path.join(templatesDir, ...segments)}.liquid`\n}\n\n/**\n * Load a Liquid template from disk, using a cache to avoid redundant reads.\n *\n * @private\n */\nfunction loadTemplateFromDisk(options: LoadTemplateOptions): Result<string, Error> {\n  const { templatesDir, type, cache } = options\n  const cached = cache.get(type)\n  if (cached !== undefined) {\n    return ok(cached)\n  }\n\n  const templatePath = resolveTemplatePath(templatesDir, type)\n  const [error, content] = attempt(() => fs.readFileSync(templatePath, 'utf8'))\n\n  if (error || content === null) {\n    return err(new Error(`Template not found for type '${type}': ${templatePath}`))\n  }\n\n  cache.set(type, content)\n  return ok(content)\n}\n\n/**\n * Resolve additional template context from the user-provided context function.\n *\n * @private\n */\nfunction resolveExtraContext(\n  context: ((params: ToMarkdownParams) => Record<string, unknown>) | undefined,\n  params: ToMarkdownParams\n): Record<string, unknown> {\n  if (context) {\n    return context(params)\n  }\n  return {}\n}\n\n/**\n * Render a Liquid template with the given parameters and context.\n *\n * @private\n */\nfunction renderTemplate(options: RenderTemplateOptions): Result<string, Error> {\n  const { liquid, template, params, extraContext } = options\n  const [error, result] = attempt(() =>\n    liquid.parseAndRenderSync(template, {\n      ...(params.data as object),\n      ...extraContext,\n    })\n  )\n\n  if (error || result === undefined) {\n    const errorMessage = resolveRenderError(error)\n    return err(new Error(`Failed to render template for ${params.type}: ${errorMessage}`))\n  }\n\n  return ok(result)\n}\n","import fs from 'node:fs'\nimport path from 'node:path'\n\nimport { attempt, err, ok } from '@kidd-cli/utils/fp'\nimport type { Result } from '@kidd-cli/utils/fp'\nimport { jsonStringify } from '@kidd-cli/utils/json'\n\nimport { redactObject } from '@/context/redact.js'\n\nimport { resolveRenderError } from './renderer.js'\nimport type { JsonOutputOptions, WriteParams } from './types.js'\n\n/**\n * Serialize data to a JSON string.\n *\n * @param data - The data to serialize.\n * @param opts - JSON output options.\n * @returns The JSON string.\n */\nexport function formatJson(data: unknown, opts: JsonOutputOptions = {}): string {\n  const { pretty = true, redact = false } = opts\n  const processed = resolveProcessed(data, redact)\n  const [, json] = jsonStringify(processed, { pretty })\n  return json || ''\n}\n\n/**\n * Write content to a file on disk, creating parent directories as needed.\n *\n * @param params - Write parameters (path and content).\n * @returns A Result indicating success or failure.\n */\nexport function writeToFile(params: WriteParams): Result<void, Error> {\n  const [error] = attempt(() => {\n    fs.mkdirSync(path.dirname(params.path), { recursive: true })\n    fs.writeFileSync(params.path, params.content, 'utf8')\n  })\n\n  if (error) {\n    const errorMessage = resolveRenderError(error)\n    return err(new Error(`Failed to write file ${params.path}: ${errorMessage}`))\n  }\n\n  return ok()\n}\n\n// ---------------------------------------------------------------------------\n// Private\n// ---------------------------------------------------------------------------\n\n/**\n * Resolve the processed data, optionally redacting sensitive fields.\n *\n * @private\n */\nfunction resolveProcessed(data: unknown, redact: boolean): unknown {\n  if (redact && data && typeof data === 'object') {\n    return redactObject(data as object)\n  }\n  return data\n}\n","import { err } from '@kidd-cli/utils/fp'\nimport type { Result } from '@kidd-cli/utils/fp'\n\nimport { createCliLogger } from '@/lib/logger.js'\n\nimport { formatJson, writeToFile } from './format.js'\nimport { createRenderer } from './renderer.js'\nimport type {\n  CliOutput,\n  CreateOutputOptions,\n  JsonOutputOptions,\n  Renderer,\n  ToMarkdownParams,\n} from './types.js'\n\n/**\n * Create a new {@link CliOutput} instance for structured CLI output.\n *\n * @param options - Output configuration.\n * @returns A CliOutput instance.\n */\nexport function createOutput(options: CreateOutputOptions = {}): CliOutput {\n  const logger = createCliLogger({ output: options.output ?? process.stdout })\n  const renderer = resolveRenderer(options)\n\n  function toMarkdown(params: ToMarkdownParams): Result<string, Error> {\n    if (!renderer) {\n      return err(\n        new Error('Templates directory not configured. Pass `templates` to createOutput().')\n      )\n    }\n    return renderer.render(params)\n  }\n\n  return {\n    json(data: unknown, jsonOptions: JsonOutputOptions = {}): void {\n      logger.print(formatJson(data, jsonOptions))\n    },\n    print(content: string): void {\n      logger.print(content)\n    },\n    toJson: formatJson,\n    toMarkdown,\n    write: writeToFile,\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Private\n// ---------------------------------------------------------------------------\n\n/**\n * Resolve a Renderer from the output options, if templates are configured.\n *\n * @private\n */\nfunction resolveRenderer(options: CreateOutputOptions): Renderer | undefined {\n  if (options.templates) {\n    return createRenderer({\n      context: options.context,\n      filters: options.filters,\n      templates: options.templates,\n    })\n  }\n  return undefined\n}\n","import { createOutput } from './create-output.js'\nimport type { CliOutput } from './types.js'\n\n/**\n * Default output instance writing to stdout.\n */\nexport const output: CliOutput = createOutput()\n"],"mappings":"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"}

package/dist/lib/project.d.ts

@@ -0,0 +1,59 @@
+import { n as ProjectRoot, r as ResolvePathOptions, t as PathSource } from "../types-Cz9h927W.js";
+
+//#region src/lib/project/paths.d.ts
+/**
+* Resolve a directory path relative to the project root.
+*
+* @param options - Options containing the directory name and optional start directory.
+* @returns The resolved local path, or null if no project root is found.
+*/
+declare function resolveLocalPath(options: {
+  readonly dirName: string;
+  readonly startDir?: string;
+}): string | null;
+/**
+* Resolve a directory path relative to the user's home directory.
+*
+* @param options - Options containing the directory name.
+* @returns The resolved global path.
+*/
+declare function resolveGlobalPath(options: {
+  readonly dirName: string;
+}): string;
+/**
+* Resolve a directory path using the specified source strategy.
+*
+* When source is 'local', resolves relative to the project root.
+* When source is 'global', resolves relative to the home directory.
+* When source is 'resolve' (default), tries local first, falling back to global.
+*
+* @param options - Resolution options with dirName, source, and startDir.
+* @returns The resolved path, or null if local resolution fails with source='local'.
+*/
+declare function resolvePath(options: ResolvePathOptions): string | null;
+//#endregion
+//#region src/lib/project/root.d.ts
+/**
+* Walk up the directory tree to find the nearest git project root.
+*
+* @param startDir - Directory to start searching from (defaults to cwd).
+* @returns The project root info, or null if no git root is found.
+*/
+declare function findProjectRoot(startDir?: string): ProjectRoot | null;
+/**
+* Check whether the current directory is inside a git submodule.
+*
+* @param startDir - Directory to start searching from.
+* @returns True if the directory is inside a submodule.
+*/
+declare function isInSubmodule(startDir?: string): boolean;
+/**
+* Resolve the parent repository root when inside a git submodule.
+*
+* @param startDir - Directory to start searching from.
+* @returns The parent repository root path, or null.
+*/
+declare function getParentRepoRoot(startDir?: string): string | null;
+//#endregion
+export { type PathSource, type ProjectRoot, type ResolvePathOptions, findProjectRoot, getParentRepoRoot, isInSubmodule, resolveGlobalPath, resolveLocalPath, resolvePath };
+//# sourceMappingURL=project.d.ts.map

package/dist/lib/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","names":[],"sources":["../../src/lib/project/paths.ts","../../src/lib/project/root.ts"],"mappings":";;;;;AAcA;;;;iBAAgB,gBAAA,CAAiB,OAAA;EAAA,SACtB,OAAA;EAAA,SACA,QAAA;AAAA;;AAeX;;;;;iBAAgB,iBAAA,CAAkB,OAAA;EAAA,SAAoB,OAAA;AAAA;;;;;;AChBtD;;;;;iBD8BgB,WAAA,CAAY,OAAA,EAAS,kBAAA;;;;;AA/BrC;;;;iBCCgB,eAAA,CAAgB,QAAA,YAAmC,WAAA;;;;;ADgBnE;;iBCsBgB,aAAA,CAAc,QAAA;;;ADR9B;;;;iBCsBgB,iBAAA,CAAkB,QAAA"}

package/dist/lib/project.js

@@ -0,0 +1,3 @@
+import { a as getParentRepoRoot, i as findProjectRoot, n as resolveLocalPath, o as isInSubmodule, r as resolvePath, t as resolveGlobalPath } from "../project-NPtYX2ZX.js";
+
+export { findProjectRoot, getParentRepoRoot, isInSubmodule, resolveGlobalPath, resolveLocalPath, resolvePath };

package/dist/lib/prompts.d.ts

@@ -0,0 +1,24 @@
+import { n as Spinner, t as PromptUtils } from "../types-DFtYg5uZ.js";
+
+//#region src/lib/prompts/create-prompts.d.ts
+/**
+* Create a new {@link Spinner} instance backed by @clack/prompts.
+*/
+declare function createSpinner(): Spinner;
+/**
+* Create a new {@link PromptUtils} instance backed by @clack/prompts.
+*/
+declare function createPromptUtils(): PromptUtils;
+//#endregion
+//#region src/lib/prompts/defaults.d.ts
+/**
+* Default spinner instance.
+*/
+declare const spinner: Spinner;
+/**
+* Default prompt utilities instance.
+*/
+declare const prompts: PromptUtils;
+//#endregion
+export { type PromptUtils, type Spinner, createPromptUtils, createSpinner, prompts, spinner };
+//# sourceMappingURL=prompts.d.ts.map

package/dist/lib/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","names":[],"sources":["../../src/lib/prompts/create-prompts.ts","../../src/lib/prompts/defaults.ts"],"mappings":";;;;;AAOA;iBAAgB,aAAA,CAAA,GAAiB,OAAA;;;;iBAqBjB,iBAAA,CAAA,GAAqB,WAAA;;;;;AArBrC;cCDa,OAAA,EAAS,OAAA;;;;cAKT,OAAA,EAAS,WAAA"}

package/dist/lib/prompts.js

@@ -0,0 +1,3 @@
+import { i as createSpinner, n as spinner, r as createPromptUtils, t as prompts } from "../prompts-lLfUSgd6.js";
+
+export { createPromptUtils, createSpinner, prompts, spinner };

package/dist/lib/store.d.ts

@@ -0,0 +1,56 @@
+import { t as PathSource } from "../types-Cz9h927W.js";
+import { Result } from "@kidd-cli/utils/fp";
+
+//#region src/lib/store/types.d.ts
+/**
+* Write-target for {@link FileStore.save}.
+*
+* Only `'local'` and `'global'` are valid — writes must target an
+* explicit directory (no automatic resolution).
+*/
+type SaveSource = "local" | "global";
+/**
+* Options for creating a file-backed store.
+*/
+interface StoreOptions<TData> {
+  dirName: string;
+  defaults?: TData;
+}
+/**
+* Options for loading a file from the store.
+*/
+interface LoadOptions {
+  source?: PathSource;
+  startDir?: string;
+}
+/**
+* Options for saving a file to the store.
+*/
+interface SaveOptions {
+  source?: SaveSource;
+  startDir?: string;
+}
+/**
+* File-backed JSON store with local/global resolution.
+*/
+interface FileStore<TData> {
+  getLocalDir(startDir?: string): string | null;
+  getGlobalDir(): string;
+  load(filename: string, options?: LoadOptions): TData | null;
+  loadRaw(filename: string, options?: LoadOptions): string | null;
+  getFilePath(filename: string, options?: LoadOptions): string | null;
+  save(filename: string, data: unknown, options?: SaveOptions): Result<string>;
+}
+//#endregion
+//#region src/lib/store/create-store.d.ts
+/**
+* Create a file-backed {@link FileStore} that resolves JSON files from project-local
+* or global home directories.
+*
+* @param options - Store configuration.
+* @returns A FileStore instance.
+*/
+declare function createStore<TData = unknown>(options: StoreOptions<TData>): FileStore<TData>;
+//#endregion
+export { type FileStore, type LoadOptions, type SaveOptions, type SaveSource, type StoreOptions, createStore };
+//# sourceMappingURL=store.d.ts.map

package/dist/lib/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","names":[],"sources":["../../src/lib/store/types.ts","../../src/lib/store/create-store.ts"],"mappings":";;;;;;AASA;;;;KAAY,UAAA;AAKZ;;;AAAA,UAAiB,YAAA;EACf,OAAA;EACA,QAAA,GAAW,KAAA;AAAA;;;;UAMI,WAAA;EACf,MAAA,GAAS,UAAA;EACT,QAAA;AAAA;;;;UAMe,WAAA;EACf,MAAA,GAAS,UAAA;EACT,QAAA;AAAA;;;;UAMe,SAAA;EACf,WAAA,CAAY,QAAA;EACZ,YAAA;EACA,IAAA,CAAK,QAAA,UAAkB,OAAA,GAAU,WAAA,GAAc,KAAA;EAC/C,OAAA,CAAQ,QAAA,UAAkB,OAAA,GAAU,WAAA;EACpC,WAAA,CAAY,QAAA,UAAkB,OAAA,GAAU,WAAA;EACxC,IAAA,CAAK,QAAA,UAAkB,IAAA,WAAe,OAAA,GAAU,WAAA,GAAc,MAAA;AAAA;;;;;;AAnChE;;;;iBCUgB,WAAA,iBAAA,CAA6B,OAAA,EAAS,YAAA,CAAa,KAAA,IAAS,SAAA,CAAU,KAAA"}

package/dist/lib/store.js

@@ -0,0 +1,4 @@
+import "../project-NPtYX2ZX.js";
+import { t as createStore } from "../create-store-BQUX0tAn.js";
+
+export { createStore };

package/dist/logger-BkQQej8h.d.ts

@@ -0,0 +1,76 @@
+//#region src/lib/logger.d.ts
+/**
+* Options for creating a logger instance.
+*/
+interface CliLoggerOptions {
+  /**
+  * Writable stream for raw output methods like {@link CliLogger.print} and {@link CliLogger.newline}.
+  * Defaults to `process.stderr`.
+  */
+  readonly output?: NodeJS.WriteStream;
+}
+/**
+* Structured logger backed by @clack/prompts for terminal UI output.
+*/
+interface CliLogger {
+  /**
+  * Log an informational message.
+  */
+  info(message: string): void;
+  /**
+  * Log a success message.
+  */
+  success(message: string): void;
+  /**
+  * Log an error message.
+  */
+  error(message: string): void;
+  /**
+  * Log a warning message.
+  */
+  warn(message: string): void;
+  /**
+  * Log a step indicator message.
+  */
+  step(message: string): void;
+  /**
+  * Log a message with an optional custom symbol prefix.
+  */
+  message(message: string, opts?: {
+    symbol?: string;
+  }): void;
+  /**
+  * Print an intro banner with an optional title.
+  */
+  intro(title?: string): void;
+  /**
+  * Print an outro banner with an optional closing message.
+  */
+  outro(message?: string): void;
+  /**
+  * Display a boxed note with an optional title.
+  */
+  note(message?: string, title?: string): void;
+  /**
+  * Write a blank line to the output stream.
+  */
+  newline(): void;
+  /**
+  * Write raw text followed by a newline to the output stream.
+  */
+  print(text: string): void;
+}
+/**
+* Create a new {@link CliLogger} instance.
+*
+* @param options - Logger configuration.
+* @returns A CliLogger wired to the given output stream.
+*/
+declare function createCliLogger(options?: CliLoggerOptions): CliLogger;
+/**
+* Default logger instance writing to stderr.
+*/
+declare const cliLogger: CliLogger;
+//#endregion
+export { createCliLogger as i, CliLoggerOptions as n, cliLogger as r, CliLogger as t };
+//# sourceMappingURL=logger-BkQQej8h.d.ts.map

package/dist/logger-BkQQej8h.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-BkQQej8h.d.ts","names":[],"sources":["../src/lib/logger.ts"],"mappings":";;AAKA;;UAAiB,gBAAA;EAKU;;;;EAAA,SAAhB,MAAA,GAAS,MAAA,CAAO,WAAA;AAAA;AAM3B;;;AAAA,UAAiB,SAAA;;;;EAIf,IAAA,CAAK,OAAA;;;;EAIL,OAAA,CAAQ,OAAA;;;;EAIR,KAAA,CAAM,OAAA;;;;EAIN,IAAA,CAAK,OAAA;;;;EAIL,IAAA,CAAK,OAAA;;;;EAIL,OAAA,CAAQ,OAAA,UAAiB,IAAA;IAAS,MAAA;EAAA;EA6BpC;;;EAzBE,KAAA,CAAM,KAAA;;;;EAIN,KAAA,CAAM,OAAA;EAqByD;AA2CjE;;EA5DE,IAAA,CAAK,OAAA,WAAkB,KAAA;EA4DD;;;EAxDtB,OAAA;;;;EAIA,KAAA,CAAM,IAAA;AAAA;;;;;;;iBASQ,eAAA,CAAgB,OAAA,GAAS,gBAAA,GAAwB,SAAA;;;;cA2CpD,SAAA,EAAW,SAAA"}

package/dist/middleware/auth.d.ts

@@ -0,0 +1,22 @@
+import { s as Middleware } from "../types-kjpRau0U.js";
+import { a as ResolverConfig, i as LoginError, n as AuthCredential, r as AuthOptions, t as AuthContext } from "../types-CqKJhsYk.js";
+
+//#region src/middleware/auth/auth.d.ts
+/**
+* Create an auth middleware that decorates `ctx.auth`.
+*
+* No credential data is stored on the context. `ctx.auth.credential()`
+* resolves passively from two sources on every call:
+* 1. File — `~/.cli-name/auth.json`
+* 2. Env — `CLI_NAME_TOKEN`
+*
+* Interactive resolvers (OAuth, prompt, custom) only run when the
+* command handler explicitly calls `ctx.auth.authenticate()`.
+*
+* @param options - Auth middleware configuration.
+* @returns A Middleware that decorates ctx.auth.
+*/
+declare function auth(options: AuthOptions): Middleware;
+//#endregion
+export { type AuthContext, type AuthCredential, type AuthOptions, type LoginError, type ResolverConfig, auth };
+//# sourceMappingURL=auth.d.ts.map

package/dist/middleware/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","names":[],"sources":["../../src/middleware/auth/auth.ts"],"mappings":";;;;;;;AAiCA;;;;;;;;;;;iBAAgB,IAAA,CAAK,OAAA,EAAS,WAAA,GAAc,UAAA"}