@carddb/client 0.1.5 → 0.2.5

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _carddb_core from '@carddb/core';
-import { Logger, LogLevel, Cache, ResourceType, CardDBConfig, RateLimitInfo, GraphQLErrorInfo, Collection, Publisher, Game, Dataset, Deck, DeckVersion, DeckCollaborator, DeckPreviewToken, DeckCreateInput, DeckUpdateInput, DeckPublishInput, DeckCollaboratorRole, DeckPreviewTokenCreateInput, DeckPreviewTokenCreatePayload, HydrateDeckEntryInput, HydratedDeckEntry, FilterInput, DatasetRecord, APIKeyInfo } from '@carddb/core';
+import { Logger, LogLevel, Cache, ResourceType, CardDBConfig, RateLimitInfo, GraphQLErrorInfo, Collection, Publisher, Game, GameCreateInput, GameUpdateInput, Dataset, DatasetSchema, Deck, ViewerDecksFilterInput, AppDecksFilterInput, PublicDecksFilterInput, DeckVersion, DeckDiff, DeckValidateInput, DeckValidation, DeckHydrateEntriesInput, DeckHydrateEntriesPayload, DeckExportFormat, DeckExportPayload, DeckSectionDefinition, DeckCollaborator, DeckPreviewToken, DeckEmbedToken, DeckAccessTokenIssuer, DeckAPIApplicationAccess, DeckCreateInput, DeckUpdateInput, DeckUpsertByExternalRefInput, DeckUpsertByExternalRefPayload, DeckClaimInput, DeckOwnershipTransferPayload, DeckTransferOwnershipInput, DeckCopyInput, DeckCopyPayload, DeckEntryAddInput, DeckEntryMutationPayload, DeckEntryUpdateInput, DeckEntryReorderInput, DeckEntryReorderPayload, DeckEntriesReplaceInput, DeckEntriesReplacePayload, DeckImportInput, DeckImportPayload, DeckImportFormatDefinition, DeckImportFormatTestInput, DeckImportFormatTestPayload, DeckImportFormatCreateInput, DeckImportFormatUpdateInput, DeckPublishInput, DeckPublishPayload, DeckRemoveInvalidEntriesInput, DeckCollaboratorRole, DeckPreviewTokenCreateInput, DeckPreviewTokenCreatePayload, DeckEmbedTokenCreateInput, DeckEmbedTokenCreatePayload, DeckAccessTokenIssuerCreateInput, DeckAPIApplicationAccessGrantInput, DeckAccessTokenExchangeInput, DeckAccessTokenExchangePayload, HydrateDeckEntryInput, HydratedDeckEntry, FilterInput, DatasetRecord, DatasetRecordsUpsertInput, DatasetRecordsUpsertPayload, DatasetRecordsDeleteInput, DatasetRecordDeleteJob, DatasetRecordDeleteJobStatus, DatasetImportPreviewInput, DatasetImportPreviewResult, DatasetImportValidateInput, BulkImportResult, DatasetImportRunInput, ImportJob, ImportJobStatus, ImportLogLevel, ImportJobLog, GameImportPreviewInput, GameImportPreview, GameImportRunInput, GameImportJob, DatasetExportInput, ExportJob, ExportJobStatus, File, FileUploadInput, PresignedUpload, APIKeyInfo } from '@carddb/core';
 export * from '@carddb/core';
 
 /**
@@ -16,6 +16,11 @@ declare const DEFAULT_RETRY_BASE_DELAY = 1000;
 declare const DEFAULT_RETRY_MAX_DELAY = 30000;
 declare class Configuration {
     apiKey?: string;
+    publishableKey?: string;
+    secretKey?: string;
+    accessToken?: string;
+    private legacyApiKey?;
+    environment?: 'TEST' | 'LIVE';
     endpoint: string;
     timeout: number;
     openTimeout: number;
@@ -65,6 +70,18 @@ declare class Configuration {
      * Validate both publisher and game access
      */
     validateAccess(publisherSlug?: string, gameKey?: string): void;
+    /**
+     * Secret-key-only helpers are for server runtimes and trusted backend workflows.
+     */
+    requireSecretCredential(operation: string): void;
+    /**
+     * API key sent on requests when no OAuth bearer token is configured.
+     */
+    requestApiKey(): string | undefined;
+    /**
+     * Explicit legacy apiKey supplied by the caller, excluding publishable/secret aliases.
+     */
+    configApiKey(): string | undefined;
     /**
      * Check if a log level should be logged
      */
@@ -215,8 +232,52 @@ interface GetGameOptions {
     /** Whether to use cache (defaults to client config) */
     cache?: boolean;
 }
+interface ListGamesOptions extends GetGameOptions {
+    /** Maximum number of results per page */
+    first?: number;
+    /** Cursor for pagination */
+    after?: string;
+    /** Include archived games */
+    includeArchived?: boolean;
+}
+interface GetGameByKeyOptions extends GetGameOptions {
+    /** Publisher ID for authenticated publisher-management lookup */
+    publisherId?: string;
+    /** Publisher slug for authenticated publisher-management lookup */
+    publisherSlug?: string;
+    /** Stable game key */
+    gameKey: string;
+}
+interface GetGameBySlugOptions extends GetGameOptions {
+    /** Publisher ID for authenticated publisher-management lookup */
+    publisherId?: string;
+    /** Publisher slug for authenticated publisher-management lookup */
+    publisherSlug?: string;
+    /** Stable game slug, currently backed by metafyGameSlug */
+    gameSlug: string;
+}
 declare class GamesResource extends BaseResource {
     constructor(connection: Connection, config: Configuration);
+    /**
+     * List games for a publisher-management context.
+     */
+    list(publisherId: string, options?: ListGamesOptions): Promise<Collection<Game>>;
+    /**
+     * Get a publisher-managed game by stable key.
+     */
+    getByKey(options: GetGameByKeyOptions): Promise<Game | null>;
+    /**
+     * Get a publisher-managed game by slug.
+     */
+    getBySlug(options: GetGameBySlugOptions): Promise<Game | null>;
+    /**
+     * Create a publisher-managed game. Requires a server-side secret credential.
+     */
+    create(input: GameCreateInput): Promise<Game>;
+    /**
+     * Update a publisher-managed game. Requires a server-side secret credential.
+     */
+    update(id: string, input: GameUpdateInput): Promise<Game>;
     /**
      * Search for games
      *
@@ -275,8 +336,40 @@ interface GetDatasetOptions {
     /** Whether to use cache (defaults to client config) */
     cache?: boolean;
 }
+interface ListDatasetsOptions extends GetDatasetOptions {
+    /** Game ID to filter datasets */
+    gameId?: string;
+    /** Include archived datasets */
+    includeArchived?: boolean;
+    /** Dataset purpose to filter by */
+    purpose?: 'DATA' | 'RULES';
+    /** Maximum number of results per page */
+    first?: number;
+    /** Cursor for pagination */
+    after?: string;
+}
+interface GetDatasetByKeyOptions extends GetDatasetOptions {
+    /** Optional publisher ID ownership check */
+    publisherId?: string;
+    /** Game ID for stable dataset-key lookup */
+    gameId: string;
+    /** Stable dataset key */
+    datasetKey: string;
+}
 declare class DatasetsResource extends BaseResource {
     constructor(connection: Connection, config: Configuration);
+    /**
+     * List datasets for a publisher-management context.
+     */
+    list(publisherId: string, options?: ListDatasetsOptions): Promise<Collection<Dataset>>;
+    /**
+     * Get a dataset by game ID and stable dataset key.
+     */
+    getByKey(options: GetDatasetByKeyOptions): Promise<Dataset | null>;
+    /**
+     * Fetch only the schema portion for a dataset.
+     */
+    getSchema(idOrOptions: string | GetDatasetByKeyOptions): Promise<DatasetSchema | null>;
     /**
      * Search for datasets
      *
@@ -323,9 +416,20 @@ interface ListDecksOptions {
     first?: number;
     /** Cursor for pagination */
     after?: string;
+    /** Include archived decks in owner lists */
+    includeArchived?: boolean;
     /** Whether to use cache (defaults to client config) */
     cache?: boolean;
 }
+interface ListViewerDecksOptions extends ListDecksOptions {
+    filter?: ViewerDecksFilterInput;
+}
+interface ListAppDecksOptions extends ListDecksOptions {
+    filter?: AppDecksFilterInput;
+}
+interface ListPublicDecksOptions extends Omit<ListDecksOptions, 'includeArchived'> {
+    filter?: PublicDecksFilterInput;
+}
 interface FetchDeckOptions {
     /** Whether to use cache (defaults to client config) */
     cache?: boolean;
@@ -335,6 +439,22 @@ type FetchDeckBySlugOptions = FetchDeckOptions;
 type ListDeckVersionsOptions = ListDecksOptions;
 type ListDeckCollaboratorsOptions = FetchDeckOptions;
 type ListDeckPreviewTokensOptions = FetchDeckOptions;
+type ListDeckEmbedTokensOptions = FetchDeckOptions;
+type ListDeckAccessTokenIssuersOptions = FetchDeckOptions;
+interface ListDeckApiApplicationAccessesOptions extends FetchDeckOptions {
+    includeRevoked?: boolean;
+}
+interface ListMyDeckApiApplicationAccessesOptions extends FetchDeckOptions {
+    applicationId?: string;
+}
+type ListDeckImportFormatsOptions = ListDecksOptions;
+interface DeckSectionDefinitionsOptions extends FetchDeckOptions {
+    publisherSlug?: string;
+    gameKey?: string;
+    gameId?: string;
+    rulesetKey?: string;
+    rulesetVersionId?: string;
+}
 interface HydrateDeckEntriesOptions {
     /** Publisher slug (uses default if configured) */
     publisherSlug?: string;
@@ -355,6 +475,10 @@ declare class DecksResource extends BaseResource {
      * Fetch a hosted deck by CardDB UUID.
      */
     fetch(id: string, options?: FetchDeckOptions): Promise<Deck | null>;
+    /**
+     * Fetch a deck by UUID using the ownership-aware `deck` API.
+     */
+    get(id: string, options?: FetchDeckOptions): Promise<Deck | null>;
     /**
      * Fetch one deck owned by the current account or API application.
      */
@@ -363,14 +487,34 @@ declare class DecksResource extends BaseResource {
      * Fetch a hosted deck by canonical or historical slug.
      */
     fetchBySlug(publisherSlug: string, gameKey: string, slug: string, options?: FetchDeckBySlugOptions): Promise<Deck | null>;
+    /**
+     * Fetch by slug using the ownership-aware `deckBySlug` API.
+     */
+    getBySlug(publisherSlug: string, gameKey: string, slug: string, options?: FetchDeckBySlugOptions): Promise<Deck | null>;
     /**
      * Fetch a hosted deck by external reference for the current API application.
      */
     fetchByExternalRef(externalRef: string, options?: FetchDeckByExternalRefOptions): Promise<Deck | null>;
+    /**
+     * Fetch by external reference using the ownership-aware `deckByExternalRef` API.
+     */
+    getByExternalRef(externalRef: string, options?: FetchDeckByExternalRefOptions): Promise<Deck | null>;
     /**
      * List decks owned by the current account or API application.
      */
     listMine(options?: ListDecksOptions): Promise<Collection<Deck>>;
+    /**
+     * List decks owned by the current account or OAuth grant.
+     */
+    listViewer(options?: ListViewerDecksOptions): Promise<Collection<Deck>>;
+    /**
+     * List app-owned decks for the current secret-key API application.
+     */
+    listApp(options?: ListAppDecksOptions): Promise<Collection<Deck>>;
+    /**
+     * List published live decks eligible for public discovery.
+     */
+    listPublic(options?: ListPublicDecksOptions): Promise<Collection<Deck>>;
     /**
      * Fetch one immutable published deck version.
      */
@@ -383,6 +527,38 @@ declare class DecksResource extends BaseResource {
      * Fetch current draft data using a revocable preview token.
      */
     preview(token: string, options?: FetchDeckOptions): Promise<Deck | null>;
+    /**
+     * Fetch published embed data using a revocable embed token.
+     */
+    embed(token: string, options?: FetchDeckOptions): Promise<Deck | null>;
+    /**
+     * Fetch token-authorized published data using an exchanged access token.
+     */
+    access(token: string, options?: FetchDeckOptions): Promise<Deck | null>;
+    /**
+     * Compare the current draft against the latest published version.
+     */
+    draftDiff(id: string, options?: FetchDeckOptions): Promise<DeckDiff>;
+    /**
+     * Compare any two readable immutable deck versions from the same deck.
+     */
+    versionDiff(fromVersionId: string, toVersionId: string, options?: FetchDeckOptions): Promise<DeckDiff>;
+    /**
+     * Validate a draft against current or explicitly requested immutable rules/data.
+     */
+    validate(id: string, input?: DeckValidateInput, options?: FetchDeckOptions): Promise<DeckValidation>;
+    /**
+     * Hydrate unpersisted deck entries against a stored deck's game without mutating the deck.
+     */
+    hydrateDeckEntries(input: DeckHydrateEntriesInput, options?: FetchDeckOptions): Promise<DeckHydrateEntriesPayload>;
+    /**
+     * Export a readable deck representation in a deterministic text format.
+     */
+    exportDeck(id: string, format?: DeckExportFormat, options?: FetchDeckOptions): Promise<DeckExportPayload>;
+    /**
+     * Resolve current or historical ruleset section definitions.
+     */
+    sectionDefinitions(options?: DeckSectionDefinitionsOptions): Promise<DeckSectionDefinition[]>;
     /**
      * List collaborators for a deck.
      */
@@ -391,6 +567,22 @@ declare class DecksResource extends BaseResource {
      * List draft preview tokens for a deck.
      */
     listPreviewTokens(deckId: string, options?: ListDeckPreviewTokensOptions): Promise<DeckPreviewToken[]>;
+    /**
+     * List published embed tokens for a deck.
+     */
+    listEmbedTokens(deckId: string, options?: ListDeckEmbedTokensOptions): Promise<DeckEmbedToken[]>;
+    /**
+     * List trusted access token issuers for a deck.
+     */
+    listAccessTokenIssuers(deckId: string, options?: ListDeckAccessTokenIssuersOptions): Promise<DeckAccessTokenIssuer[]>;
+    /**
+     * List API applications with explicit access to one owned deck.
+     */
+    listApiApplicationAccesses(deckId: string, options?: ListDeckApiApplicationAccessesOptions): Promise<DeckAPIApplicationAccess[]>;
+    /**
+     * List selected-deck grants for the current account.
+     */
+    listMyApiApplicationAccesses(options?: ListMyDeckApiApplicationAccessesOptions): Promise<DeckAPIApplicationAccess[]>;
     /**
      * Create a hosted deck.
      */
@@ -399,14 +591,102 @@ declare class DecksResource extends BaseResource {
      * Update a hosted deck.
      */
     update(id: string, input: DeckUpdateInput): Promise<Deck>;
+    /**
+     * Update deck-level metadata without mutating entries.
+     */
+    updateMetadata(id: string, input: DeckUpdateInput): Promise<Deck>;
+    /**
+     * Create or replace a draft by API-application external reference.
+     */
+    upsertByExternalRef(input: DeckUpsertByExternalRefInput): Promise<DeckUpsertByExternalRefPayload>;
+    /**
+     * Claim an app-owned deck into the consenting OAuth user's account.
+     */
+    claim(id: string, input: DeckClaimInput): Promise<DeckOwnershipTransferPayload>;
+    /**
+     * Transfer a deck to another account.
+     */
+    transferOwnership(id: string, input: DeckTransferOwnershipInput): Promise<DeckOwnershipTransferPayload>;
+    /**
+     * Copy a deck into the current principal's ownership namespace.
+     */
+    copy(id: string, input: DeckCopyInput): Promise<DeckCopyPayload>;
+    /**
+     * Add one entry to a deck draft.
+     */
+    addEntry(input: DeckEntryAddInput): Promise<DeckEntryMutationPayload>;
+    /**
+     * Update one stable deck entry.
+     */
+    updateEntry(id: string, input: DeckEntryUpdateInput): Promise<DeckEntryMutationPayload>;
+    /**
+     * Remove one stable deck entry.
+     */
+    removeEntry(id: string, expectedDraftRevision: number): Promise<DeckEntryMutationPayload>;
+    /**
+     * Reorder deck entries within or across sections.
+     */
+    reorderEntries(deckId: string, input: DeckEntryReorderInput): Promise<DeckEntryReorderPayload>;
+    /**
+     * Explicitly replace all deck entries for import or repair flows.
+     */
+    replaceEntries(deckId: string, input: DeckEntriesReplaceInput): Promise<DeckEntriesReplacePayload>;
+    /**
+     * Import a decklist into an existing deck or dry-run resolution.
+     */
+    importDeck(input: DeckImportInput): Promise<DeckImportPayload>;
+    /**
+     * List publisher-managed configured import formats for a game.
+     */
+    listImportFormats(gameId: string, options?: ListDeckImportFormatsOptions): Promise<Collection<DeckImportFormatDefinition>>;
+    /**
+     * Fetch one configured import format by UUID.
+     */
+    fetchImportFormat(id: string, options?: FetchDeckOptions): Promise<DeckImportFormatDefinition | null>;
+    /**
+     * Preview configured import-format parsing and record resolution.
+     */
+    testImportFormat(input: DeckImportFormatTestInput): Promise<DeckImportFormatTestPayload>;
+    /**
+     * Create a publisher-managed configured import format.
+     */
+    createImportFormat(input: DeckImportFormatCreateInput): Promise<DeckImportFormatDefinition>;
+    /**
+     * Update a publisher-managed configured import format.
+     */
+    updateImportFormat(id: string, input: DeckImportFormatUpdateInput): Promise<DeckImportFormatDefinition>;
+    /**
+     * Archive a configured import format.
+     */
+    archiveImportFormat(id: string): Promise<DeckImportFormatDefinition>;
+    /**
+     * Restore an archived configured import format.
+     */
+    unarchiveImportFormat(id: string): Promise<DeckImportFormatDefinition>;
     /**
      * Delete a hosted deck.
      */
     delete(id: string): Promise<boolean>;
+    /**
+     * Recoverably hide a deck from normal owner and public lists.
+     */
+    archive(id: string): Promise<Deck>;
+    /**
+     * Restore an archived deck to draft or published state.
+     */
+    restore(id: string): Promise<Deck>;
+    /**
+     * Remove the current public published pointer while keeping version history.
+     */
+    unpublish(id: string): Promise<Deck>;
     /**
      * Publish the current draft as an immutable deck version.
      */
-    publish(id: string, input?: DeckPublishInput): Promise<DeckVersion>;
+    publish(id: string, input: DeckPublishInput): Promise<DeckPublishPayload>;
+    /**
+     * Remove draft entries that fail card-reference validation.
+     */
+    removeInvalidEntries(id: string, input: DeckRemoveInvalidEntriesInput): Promise<Deck>;
     /**
      * Create or update a deck collaborator.
      */
@@ -423,6 +703,42 @@ declare class DecksResource extends BaseResource {
      * Revoke a draft preview token.
      */
     revokePreviewToken(id: string): Promise<boolean>;
+    /**
+     * Create a revocable published embed token.
+     */
+    createEmbedToken(input: DeckEmbedTokenCreateInput): Promise<DeckEmbedTokenCreatePayload>;
+    /**
+     * Revoke a published embed token.
+     */
+    revokeEmbedToken(id: string): Promise<boolean>;
+    /**
+     * Trust the current API application to exchange short-lived deck access tokens.
+     */
+    createAccessTokenIssuer(input: DeckAccessTokenIssuerCreateInput): Promise<DeckAccessTokenIssuer>;
+    /**
+     * Revoke a trusted deck access token issuer.
+     */
+    revokeAccessTokenIssuer(id: string): Promise<boolean>;
+    /**
+     * Revoke only the direct signing key for a trusted deck access token issuer.
+     */
+    revokeAccessTokenIssuerSigningKey(id: string): Promise<DeckAccessTokenIssuer>;
+    /**
+     * Grant or update one OAuth app's selected-deck access.
+     */
+    grantApiApplicationAccess(input: DeckAPIApplicationAccessGrantInput): Promise<DeckAPIApplicationAccess>;
+    /**
+     * Revoke one OAuth app's selected-deck access.
+     */
+    revokeApiApplicationAccess(deckId: string, apiApplicationId: string): Promise<boolean>;
+    /**
+     * Exchange the current trusted API application credential for a deck access token.
+     */
+    exchangeAccessToken(input: DeckAccessTokenExchangeInput): Promise<DeckAccessTokenExchangePayload>;
+    /**
+     * Revoke an exchanged deck access token.
+     */
+    revokeAccessToken(id: string): Promise<boolean>;
     /**
      * Hydrate third-party-owned deck entries without storing them in CardDB.
      */
@@ -513,8 +829,83 @@ interface GetRecordsByIdentifierOptions {
     /** Whether to use cache (defaults to client config) */
     cache?: boolean;
 }
+interface ListRecordsOptions {
+    /** Dataset ID to list records from */
+    datasetId: string;
+    /** Filter conditions - can be an object or a builder function */
+    filter?: FilterInput;
+    /** Sort field and direction */
+    orderBy?: {
+        field: string;
+        direction?: 'ASC' | 'DESC';
+    };
+    /** Maximum number of results per page */
+    first?: number;
+    /** Cursor for forward pagination */
+    after?: string;
+    /** Maximum number of results for backward pagination */
+    last?: number;
+    /** Cursor for backward pagination */
+    before?: string;
+    /** Validate and sanitize against schema */
+    validateSchema?: boolean;
+    /** Whether to use cache (defaults to client config) */
+    cache?: boolean;
+}
+interface GetRecordByDatasetIdentifierOptions extends GetRecordOptions {
+    /** Dataset ID to search */
+    datasetId: string;
+    /** Identifier value to look up */
+    identifier: string;
+}
+interface ListRecordDeleteJobsOptions {
+    /** Dataset ID to filter jobs */
+    datasetId?: string;
+    /** Job status to filter by */
+    status?: DatasetRecordDeleteJobStatus;
+    /** Maximum number of results per page */
+    first?: number;
+    /** Cursor for pagination */
+    after?: string;
+    /** Whether to use cache (defaults to client config) */
+    cache?: boolean;
+}
+interface WaitForRecordDeleteJobOptions {
+    /** Polling interval in milliseconds */
+    intervalMs?: number;
+    /** Max time to wait in milliseconds */
+    timeoutMs?: number;
+}
 declare class RecordsResource extends BaseResource {
     constructor(connection: Connection, config: Configuration);
+    /**
+     * List records in a publisher-accessible dataset by dataset ID.
+     */
+    list(options: ListRecordsOptions): Promise<Collection<DatasetRecord>>;
+    /**
+     * Get a publisher-accessible record by dataset ID and identifier value.
+     */
+    getByDatasetIdentifier(options: GetRecordByDatasetIdentifierOptions): Promise<DatasetRecord | null>;
+    /**
+     * Start an import-backed batch upsert, or return a dry-run result. Requires a secret credential.
+     */
+    upsertBatch(input: DatasetRecordsUpsertInput): Promise<DatasetRecordsUpsertPayload>;
+    /**
+     * Create a dry-run or destructive bulk delete/reconciliation job. Requires a secret credential.
+     */
+    deleteBatch(input: DatasetRecordsDeleteInput): Promise<DatasetRecordDeleteJob>;
+    /**
+     * Get one bulk delete/reconciliation job.
+     */
+    getDeleteJob(id: string, options?: GetRecordOptions): Promise<DatasetRecordDeleteJob | null>;
+    /**
+     * List bulk delete/reconciliation jobs for a publisher.
+     */
+    listDeleteJobs(publisherId: string, options?: ListRecordDeleteJobsOptions): Promise<Collection<DatasetRecordDeleteJob>>;
+    /**
+     * Poll a delete job until it reaches a terminal state.
+     */
+    waitForDeleteJob(id: string, options?: WaitForRecordDeleteJobOptions): Promise<DatasetRecordDeleteJob>;
     /**
      * Search for records in a dataset with filtering, search, and pagination
      *
@@ -693,6 +1084,262 @@ declare class RulesResource extends BaseResource {
     private searchRuleRecords;
 }
 
+/**
+ * Publisher-managed import format resource for CardDB API
+ */
+
+interface ListImportFormatsOptions {
+    /** Publisher ID for publisher-scoped listing */
+    publisherId?: string;
+    /** Game ID for game-scoped listing */
+    gameId?: string;
+    /** Include archived definitions */
+    includeArchived?: boolean;
+    /** Maximum number of results per page */
+    first?: number;
+    /** Cursor for pagination */
+    after?: string;
+    /** Whether to use cache (defaults to client config) */
+    cache?: boolean;
+}
+interface GetImportFormatOptions {
+    /** Whether to use cache (defaults to client config) */
+    cache?: boolean;
+}
+interface GetImportFormatByKeyOptions extends GetImportFormatOptions {
+    /** Game ID for stable format-key lookup */
+    gameId: string;
+    /** Stable import format key */
+    key: string;
+}
+declare class ImportFormatsResource extends BaseResource {
+    constructor(connection: Connection, config: Configuration);
+    /**
+     * List publisher-managed import formats by publisher or game scope.
+     */
+    list(options: ListImportFormatsOptions): Promise<Collection<DeckImportFormatDefinition>>;
+    /**
+     * Get one import format by UUID.
+     */
+    get(id: string, options?: GetImportFormatOptions): Promise<DeckImportFormatDefinition | null>;
+    /**
+     * Get one import format by game ID and stable key.
+     */
+    getByKey(options: GetImportFormatByKeyOptions): Promise<DeckImportFormatDefinition | null>;
+    /**
+     * Preview parsing and record resolution for a configured import format.
+     */
+    test(input: DeckImportFormatTestInput): Promise<DeckImportFormatTestPayload>;
+    /**
+     * Create an import format. Requires a server-side secret credential.
+     */
+    create(input: DeckImportFormatCreateInput): Promise<DeckImportFormatDefinition>;
+    /**
+     * Update an import format. Requires a server-side secret credential.
+     */
+    update(id: string, input: DeckImportFormatUpdateInput): Promise<DeckImportFormatDefinition>;
+    /**
+     * Archive an import format. Requires a server-side secret credential.
+     */
+    archive(id: string): Promise<DeckImportFormatDefinition>;
+    /**
+     * Restore an archived import format. Requires a server-side secret credential.
+     */
+    unarchive(id: string): Promise<DeckImportFormatDefinition>;
+}
+
+/**
+ * Publisher import jobs resource for CardDB API
+ */
+
+interface ListImportJobsOptions {
+    /** Dataset ID to filter by */
+    datasetId?: string;
+    /** Job status to filter by */
+    status?: ImportJobStatus;
+    /** Maximum number of results per page */
+    first?: number;
+    /** Cursor for pagination */
+    after?: string;
+    /** Whether to use cache (defaults to client config) */
+    cache?: boolean;
+}
+interface ListGameImportJobsOptions {
+    /** Job status to filter by */
+    status?: ImportJobStatus;
+    /** Maximum number of results per page */
+    first?: number;
+    /** Cursor for pagination */
+    after?: string;
+    /** Whether to use cache (defaults to client config) */
+    cache?: boolean;
+}
+interface ListImportJobLogsOptions {
+    /** Log level to filter by */
+    level?: ImportLogLevel;
+    /** Dataset key to filter by */
+    datasetKey?: string;
+    /** Maximum number of results per page */
+    first?: number;
+    /** Cursor for pagination */
+    after?: string;
+    /** Whether to use cache (defaults to client config) */
+    cache?: boolean;
+}
+interface WaitForImportJobOptions {
+    /** Polling interval in milliseconds */
+    intervalMs?: number;
+    /** Max time to wait in milliseconds */
+    timeoutMs?: number;
+}
+declare class ImportsResource extends BaseResource {
+    constructor(connection: Connection, config: Configuration);
+    /**
+     * Preview a single-dataset import source without writing records or schema.
+     */
+    preview(input: DatasetImportPreviewInput): Promise<DatasetImportPreviewResult>;
+    /**
+     * Validate a single-dataset import source with dry-run enforced.
+     */
+    validate(input: DatasetImportValidateInput): Promise<BulkImportResult>;
+    /**
+     * Start an async single-dataset import from `fileId`, `data`, or `sourceUrl`.
+     */
+    run(input: DatasetImportRunInput): Promise<ImportJob>;
+    /**
+     * Fetch one single-dataset import job.
+     */
+    getJob(id: string, options?: {
+        cache?: boolean;
+    }): Promise<ImportJob | null>;
+    /**
+     * List single-dataset import jobs for a publisher.
+     */
+    listJobs(publisherId: string, options?: ListImportJobsOptions): Promise<Collection<ImportJob>>;
+    /**
+     * Cancel a pending or processing single-dataset import job.
+     */
+    cancelJob(id: string): Promise<ImportJob>;
+    /**
+     * List structured logs for one single-dataset import job.
+     */
+    listJobLogs(importJobId: string, options?: ListImportJobLogsOptions): Promise<Collection<ImportJobLog>>;
+    /**
+     * Poll a single-dataset import job until completion or failure.
+     */
+    waitForJob(id: string, options?: WaitForImportJobOptions): Promise<ImportJob>;
+    /**
+     * Preview an advanced game-level import source without writing records or schema.
+     */
+    previewGame(input: GameImportPreviewInput): Promise<GameImportPreview>;
+    /**
+     * Start an async advanced game-level import from `fileId`, `data`, or `sourceUrl`.
+     */
+    runGame(input: GameImportRunInput): Promise<GameImportJob>;
+    /**
+     * Fetch one advanced game-level import job.
+     */
+    getGameJob(id: string, options?: {
+        cache?: boolean;
+    }): Promise<GameImportJob | null>;
+    /**
+     * List advanced game-level import jobs.
+     */
+    listGameJobs(gameId: string, options?: ListGameImportJobsOptions): Promise<Collection<GameImportJob>>;
+    /**
+     * Cancel a pending or processing advanced game-level import job.
+     */
+    cancelGameJob(id: string): Promise<GameImportJob>;
+    /**
+     * Poll an advanced game-level import job until completion or failure.
+     */
+    waitForGameJob(id: string, options?: WaitForImportJobOptions): Promise<GameImportJob>;
+}
+
+/**
+ * Publisher dataset export jobs resource for CardDB API
+ */
+
+interface ListExportJobsOptions {
+    /** Game ID to filter by */
+    gameId?: string;
+    /** Dataset ID to filter by */
+    datasetId?: string;
+    /** Job status to filter by */
+    status?: ExportJobStatus;
+    /** Maximum number of results per page */
+    first?: number;
+    /** Cursor for pagination */
+    after?: string;
+    /** Whether to use cache (defaults to client config) */
+    cache?: boolean;
+}
+interface WaitForExportJobOptions {
+    /** Polling interval in milliseconds */
+    intervalMs?: number;
+    /** Max time to wait in milliseconds */
+    timeoutMs?: number;
+}
+declare class ExportsResource extends BaseResource {
+    constructor(connection: Connection, config: Configuration);
+    /**
+     * Start an async dataset export. Requires a server-side secret credential.
+     */
+    run(input: DatasetExportInput): Promise<ExportJob>;
+    /** Alias for `run`. */
+    create(input: DatasetExportInput): Promise<ExportJob>;
+    /**
+     * Fetch one export job.
+     */
+    getJob(id: string, options?: {
+        cache?: boolean;
+    }): Promise<ExportJob | null>;
+    /**
+     * List export jobs for a publisher, optionally filtered by game, dataset, or status.
+     */
+    listJobs(publisherId: string, options?: ListExportJobsOptions): Promise<Collection<ExportJob>>;
+    /**
+     * Refresh the signed download URL for a completed export job.
+     */
+    refreshUrl(id: string): Promise<ExportJob>;
+    /**
+     * Cancel a pending or processing export job. Requires a server-side secret credential.
+     */
+    cancel(id: string): Promise<ExportJob>;
+    /**
+     * Poll an export job until completion or failure.
+     */
+    waitForJob(id: string, options?: WaitForExportJobOptions): Promise<ExportJob>;
+}
+
+/**
+ * File upload helper resource for CardDB API
+ */
+
+interface GetFileOptions {
+    /** Whether to use cache (defaults to client config) */
+    cache?: boolean;
+}
+declare class FilesResource extends BaseResource {
+    constructor(connection: Connection, config: Configuration);
+    /**
+     * Get one file by ID.
+     */
+    get(id: string, options?: GetFileOptions): Promise<File | null>;
+    /**
+     * Request a presigned URL for direct upload. Requires a server-side secret credential.
+     */
+    requestUpload(input: FileUploadInput): Promise<PresignedUpload>;
+    /**
+     * Confirm that a presigned upload completed.
+     */
+    confirmUpload(id: string): Promise<File>;
+    /**
+     * Delete a file. Requires a server-side secret credential.
+     */
+    delete(id: string): Promise<boolean>;
+}
+
 /**
  * CardDB API Client
  *
@@ -756,6 +1403,14 @@ declare class CardDBClient {
     readonly decks: DecksResource;
     /** Rules resource for game rules and deck formats */
     readonly rules: RulesResource;
+    /** Publisher-managed import format resource */
+    readonly importFormats: ImportFormatsResource;
+    /** Publisher import job resource */
+    readonly imports: ImportsResource;
+    /** Publisher dataset export job resource */
+    readonly exports: ExportsResource;
+    /** File upload helper resource */
+    readonly files: FilesResource;
     /**
      * Create a new CardDB client
      *
@@ -837,4 +1492,4 @@ declare function readCache<T>(cache: Cache, key: string): Promise<T | null>;
  */
 declare function writeCache<T>(cache: Cache, key: string, value: T, ttl: number): Promise<void>;
 
-export { BaseResource, CardDBClient, Configuration, Connection, DEFAULT_CACHE_TTL, DEFAULT_ENDPOINT, DEFAULT_MAX_NETWORK_RETRIES, DEFAULT_MAX_RETRIES, DEFAULT_OPEN_TIMEOUT, DEFAULT_RETRY_BASE_DELAY, DEFAULT_RETRY_MAX_DELAY, DEFAULT_TIMEOUT, DatasetsResource, DecksResource, type FetchDeckByExternalRefOptions, type FetchDeckBySlugOptions, type FetchDeckOptions, GamesResource, type GetDatasetOptions, type GetGameOptions, type GetPublisherOptions, type GetRecordByIdentifierOptions, type GetRecordOptions, type GetRecordsByIdentifierOptions, type GraphQLResponse, type HydrateDeckEntriesOptions, type ListDeckCollaboratorsOptions, type ListDeckPreviewTokensOptions, type ListDeckVersionsOptions, type ListDecksOptions, type ListFormatsOptions, type ListRuleDatasetsOptions, type ListRulesOptions, PublishersResource, RecordsResource, RulesResource, type SearchDatasetsOptions, type SearchGamesOptions, type SearchPublishersOptions, type SearchRecordsOptions, cacheKey, getRateLimitInfo, getSDKVersion, getUserAgent, readCache, writeCache };
+export { BaseResource, CardDBClient, Configuration, Connection, DEFAULT_CACHE_TTL, DEFAULT_ENDPOINT, DEFAULT_MAX_NETWORK_RETRIES, DEFAULT_MAX_RETRIES, DEFAULT_OPEN_TIMEOUT, DEFAULT_RETRY_BASE_DELAY, DEFAULT_RETRY_MAX_DELAY, DEFAULT_TIMEOUT, DatasetsResource, type DeckSectionDefinitionsOptions, DecksResource, ExportsResource, type FetchDeckByExternalRefOptions, type FetchDeckBySlugOptions, type FetchDeckOptions, FilesResource, GamesResource, type GetDatasetByKeyOptions, type GetDatasetOptions, type GetFileOptions, type GetGameByKeyOptions, type GetGameBySlugOptions, type GetGameOptions, type GetImportFormatByKeyOptions, type GetImportFormatOptions, type GetPublisherOptions, type GetRecordByDatasetIdentifierOptions, type GetRecordByIdentifierOptions, type GetRecordOptions, type GetRecordsByIdentifierOptions, type GraphQLResponse, type HydrateDeckEntriesOptions, ImportFormatsResource, ImportsResource, type ListAppDecksOptions, type ListDatasetsOptions, type ListDeckAccessTokenIssuersOptions, type ListDeckApiApplicationAccessesOptions, type ListDeckCollaboratorsOptions, type ListDeckEmbedTokensOptions, type ListDeckImportFormatsOptions, type ListDeckPreviewTokensOptions, type ListDeckVersionsOptions, type ListDecksOptions, type ListExportJobsOptions, type ListFormatsOptions, type ListGameImportJobsOptions, type ListGamesOptions, type ListImportFormatsOptions, type ListImportJobLogsOptions, type ListImportJobsOptions, type ListMyDeckApiApplicationAccessesOptions, type ListPublicDecksOptions, type ListRecordDeleteJobsOptions, type ListRecordsOptions, type ListRuleDatasetsOptions, type ListRulesOptions, type ListViewerDecksOptions, PublishersResource, RecordsResource, RulesResource, type SearchDatasetsOptions, type SearchGamesOptions, type SearchPublishersOptions, type SearchRecordsOptions, type WaitForExportJobOptions, type WaitForImportJobOptions, type WaitForRecordDeleteJobOptions, cacheKey, getRateLimitInfo, getSDKVersion, getUserAgent, readCache, writeCache };