// generated by diplomat-tool
import type { NucleationError } from "./NucleationError.mjs"
import type { Schematic } from "./Schematic.mjs"
import type { pointer, codepoint } from "./diplomat-runtime.d.ts";



/**
 * Namespace type for the URI-based transparent I/O and format-manager
 * queries (PORTING rule 12).
 */
export class StoreIo {
    /** @internal */
    get ffiValue(): pointer;
    /** @internal */
    constructor();


    /**
     * Open a schematic from a URI: a local path, `file://...`, or
     * `s3://bucket/key.schem`. The format is auto-detected from the URI's
     * extension. Single-string URIs for `redis://`, `postgres://`, and
     * `mem://` are rejected by the core resolver; use `Store::open_schematic`
     * with an explicit store for those backends.
     */
    static open(uri: string): Schematic;

    /**
     * Save a schematic to a URI: a local path, `file://...`, or
     * `s3://bucket/key.schem`. The format is auto-detected from the URI's
     * extension; `version` selects the format version (empty string =
     * format default). Single-string URIs for `redis://`, `postgres://`, and
     * `mem://` are rejected by the core resolver; use `Store::save_schematic`
     * with an explicit store for those backends.
     */
    static save(schematic: Schematic, uri: string, version: string): void;

    /**
     * The JSON schema describing the export settings of `format`. Errors
     * with `NotFound` for an unknown format.
     */
    static exportSettingsSchema(format: string): string;

    /**
     * The JSON schema describing the import settings of `format`. Errors
     * with `NotFound` for an unknown format.
     */
    static importSettingsSchema(format: string): string;

    /**
     * The supported import formats, written as a JSON array string.
     */
    static supportedImportFormats(): string;

    /**
     * The supported export formats, written as a JSON array string.
     */
    static supportedExportFormats(): string;

    /**
     * The known versions of an export format, written as a JSON array string
     * (empty array for an unknown format, matching the old ABI).
     */
    static formatVersions(format: string): string;

    /**
     * The default version of an export format. Errors with `NotFound` for an
     * unknown format.
     */
    static defaultFormatVersion(format: string): string;
}