@carddb/client 0.4.5 → 0.5.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as _carddb_core from '@carddb/core';
-import { Logger, LogLevel, Cache, ResourceType, CardDBConfig, RateLimitInfo, GraphQLErrorInfo, Collection, Publisher, Game, GameCreateInput, GameUpdateInput, GameScanRegion, Dataset, DatasetSchema, Deck, DeckReadState, DeckPublishedVersionSelector, ViewerDecksFilterInput, AppDecksFilterInput, PublicDecksFilterInput, DeckVersion, DeckDiff, DeckValidateInput, DeckValidation, DeckHydrateEntriesInput, DeckHydrateEntriesPayload, DeckExportFormat, DeckExportPayload, DeckSectionDefinition, DeckCollaborator, 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, DeckTokenIssuerCreateInput, DeckTokenIssuer, DeckAPIApplicationAccessGrantInput, DeckTokenExchangeInput, DeckTokenExchangePayload, 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, UploadPurpose, CreateScanUploadSessionInput, ConfirmScanUploadInput, CreateScanJobInput, ScanJobPayload, ScanJob, SubmitScanFeedbackInput, ScanFeedbackPayload, ScanMetricsInput, ScanMetrics, ResolveScanTemplateInput, ScanTemplateResolution, ScanTemplatesInput, ScanTemplate, SaveScanTemplateInput, ScanTemplatePayload, PreviewScanTemplateInput, ScanTemplatePreview, APIKeyInfo } from '@carddb/core';
+import { Logger, LogLevel, Cache, ResourceType, CardDBConfig, RateLimitInfo, GraphQLErrorInfo, Collection, Publisher, Game, GameCreateInput, GameUpdateInput, GameScanRegion, Dataset, DatasetSchema, DatasetFilterValueConnection, Deck, DeckReadState, DeckPublishedVersionSelector, ViewerDecksFilterInput, AppDecksFilterInput, PublicDecksFilterInput, DeckVersion, DeckDiff, DeckValidateInput, DeckValidation, DeckHydrateEntriesInput, DeckHydrateEntriesPayload, DeckExportFormat, DeckExportPayload, DeckSectionDefinition, DeckCollaborator, 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, DeckTokenIssuerCreateInput, DeckTokenIssuer, DeckAPIApplicationAccessGrantInput, DeckTokenExchangeInput, DeckTokenExchangePayload, HydrateDeckEntryInput, HydratedDeckEntry, FilterInput, DatasetRecord, DatasetRecordsUpsertInput, DatasetRecordsUpsertPayload, DatasetRecordsDeleteInput, DatasetRecordDeleteJob, DatasetRecordDeleteJobStatus, Ruleset, RulesetVersionStatus, RulesetVersion, DeckValidationRules, RulesetVersionDraftImportFromDatasetRecordInput, RulesetVersionDraftImportPreview, RulesetValidationImpact, RulesetCreateInput, RulesetUpdateInput, RulesetVersionDraftCreateInput, RulesetVersionDraftUpdateInput, RulesetVersionPublishInput, DatasetImportPreviewInput, DatasetImportPreviewResult, DatasetImportValidateInput, BulkImportResult, DatasetImportRunInput, ImportJob, ImportJobStatus, ImportLogLevel, ImportJobLog, GameImportPreviewInput, GameImportPreview, GameImportRunInput, GameImportJob, DatasetExportInput, ExportJob, ExportJobStatus, File, FileUploadInput, PresignedUpload, UploadPurpose, CreateScanUploadSessionInput, ConfirmScanUploadInput, CreateScanJobInput, ScanJobPayload, ScanJob, SubmitScanFeedbackInput, ScanFeedbackPayload, ScanMetricsInput, ScanMetrics, ResolveScanTemplateInput, ScanTemplateResolution, ScanTemplatesInput, ScanTemplate, SaveScanTemplateInput, ScanTemplatePayload, PreviewScanTemplateInput, ScanTemplatePreview, APIKeyInfo } from '@carddb/core';
 export * from '@carddb/core';
 
 /**
@@ -368,6 +368,16 @@ interface GetDatasetByKeyOptions extends GetDatasetOptions {
     /** Stable dataset key */
     datasetKey: string;
 }
+interface DatasetFilterValuesOptions extends GetDatasetOptions {
+    /** Optional case-insensitive search within values */
+    search?: string;
+    /** Include per-value record counts. More expensive than listing values only. */
+    includeCounts?: boolean;
+    /** Maximum number of values per field (default: 50, max: 500) */
+    first?: number;
+    /** Cursor for pagination. Applies to each requested field. */
+    after?: string;
+}
 declare class DatasetsResource extends BaseResource {
     constructor(connection: Connection, config: Configuration);
     /**
@@ -417,6 +427,20 @@ declare class DatasetsResource extends BaseResource {
      * const datasets = await client.datasets.getMany(['id1', 'id2', 'id3'])
      */
     getMany(ids: string[], options?: GetDatasetOptions): Promise<Dataset[]>;
+    /**
+     * Get distinct filter values for one or more filterable fields.
+     *
+     * @example
+     * const values = await client.datasets.filterValues('dataset-id', ['name', 'colors'], {
+     *   includeCounts: true,
+     *   first: 500,
+     * })
+     */
+    filterValues(id: string, fields: string[], options?: DatasetFilterValuesOptions): Promise<DatasetFilterValueConnection[]>;
+    /**
+     * Get distinct filter values for a dataset by publisher/game/dataset keys.
+     */
+    filterValues(publisherSlug: string, gameKey: string, datasetKey: string, fields: string[], options?: DatasetFilterValuesOptions): Promise<DatasetFilterValueConnection[]>;
 }
 
 /**
@@ -1080,6 +1104,119 @@ declare class RulesResource extends BaseResource {
     private searchRuleRecords;
 }
 
+/**
+ * First-class rulesets resource for CardDB API
+ */
+
+interface ListRulesetsOptions {
+    /** Include archived rulesets */
+    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;
+}
+type ListPublicRulesetsOptions = Omit<ListRulesetsOptions, 'includeArchived'>;
+interface GetRulesetOptions {
+    /** Whether to use cache (defaults to client config) */
+    cache?: boolean;
+}
+interface GetRulesetByKeyOptions extends GetRulesetOptions {
+    /** Game ID for stable ruleset-key lookup */
+    gameId: string;
+    /** Stable ruleset key */
+    key: string;
+}
+interface ListRulesetVersionsOptions extends GetRulesetOptions {
+    /** Optional status filter */
+    status?: RulesetVersionStatus;
+    /** Maximum number of results per page */
+    first?: number;
+    /** Cursor for pagination */
+    after?: string;
+}
+interface RulesetValidationRulesOptions extends GetRulesetOptions {
+    /** Optional immutable ruleset version override */
+    rulesetVersionId?: string;
+}
+interface RulesetValidationImpactOptions extends GetRulesetOptions {
+    /** Maximum number of affected decks to include */
+    first?: number;
+}
+declare class RulesetsResource extends BaseResource {
+    constructor(connection: Connection, config: Configuration);
+    /**
+     * List first-class rulesets for a game.
+     */
+    list(gameId: string, options?: ListRulesetsOptions): Promise<Collection<Ruleset>>;
+    /**
+     * List active public rulesets for a public game.
+     */
+    listPublic(gameId: string, options?: ListPublicRulesetsOptions): Promise<Collection<Ruleset>>;
+    /**
+     * Get one ruleset by UUID.
+     */
+    get(id: string, options?: GetRulesetOptions): Promise<Ruleset | null>;
+    /**
+     * Get one ruleset by game ID and stable key.
+     */
+    getByKey(options: GetRulesetByKeyOptions): Promise<Ruleset | null>;
+    /**
+     * List immutable versions for a ruleset.
+     */
+    versions(rulesetId: string, options?: ListRulesetVersionsOptions): Promise<Collection<RulesetVersion>>;
+    /**
+     * Get one immutable ruleset version by UUID.
+     */
+    getVersion(id: string, options?: GetRulesetOptions): Promise<RulesetVersion | null>;
+    /**
+     * Get the canonical active rules JSON for a ruleset.
+     */
+    validationRules(gameId: string, rulesetKey: string, options?: RulesetValidationRulesOptions): Promise<Record<string, unknown> | null>;
+    /**
+     * Get typed validation rules, including parsed deck sections.
+     */
+    deckValidationRules(gameId: string, rulesetKey: string, options?: RulesetValidationRulesOptions): Promise<DeckValidationRules | null>;
+    /**
+     * Preview compiling a legacy formats dataset record into a draft ruleset version.
+     */
+    previewImport(rulesetId: string, input: RulesetVersionDraftImportFromDatasetRecordInput): Promise<RulesetVersionDraftImportPreview>;
+    /**
+     * Preview validation impact for decks that use a ruleset version's parent ruleset.
+     */
+    validationImpact(rulesetVersionId: string, options?: RulesetValidationImpactOptions): Promise<RulesetValidationImpact>;
+    /**
+     * Create a first-class ruleset. Requires a server-side secret credential.
+     */
+    create(input: RulesetCreateInput): Promise<Ruleset>;
+    /**
+     * Update editable ruleset metadata. Requires a server-side secret credential.
+     */
+    update(id: string, input: RulesetUpdateInput): Promise<Ruleset>;
+    /**
+     * Create a draft ruleset version from an explicit canonical rules payload.
+     */
+    createDraft(rulesetId: string, input: RulesetVersionDraftCreateInput): Promise<RulesetVersion>;
+    /**
+     * Create a draft by compiling a legacy formats dataset record.
+     */
+    importDraftFromDatasetRecord(rulesetId: string, input: RulesetVersionDraftImportFromDatasetRecordInput): Promise<RulesetVersion>;
+    /**
+     * Update a draft ruleset version.
+     */
+    updateDraft(id: string, input: RulesetVersionDraftUpdateInput): Promise<RulesetVersion>;
+    /**
+     * Publish a draft and make it the current active ruleset version.
+     */
+    publishVersion(id: string, input?: RulesetVersionPublishInput): Promise<RulesetVersion>;
+    /**
+     * Activate an already-published version for rollback.
+     */
+    activateVersion(id: string): Promise<RulesetVersion>;
+}
+
 /**
  * Publisher-managed import format resource for CardDB API
  */
@@ -1574,6 +1711,8 @@ declare class CardDBClient {
     readonly decks: DecksResource;
     /** Rules resource for game rules and deck formats */
     readonly rules: RulesResource;
+    /** First-class rulesets resource for deck validation rules */
+    readonly rulesets: RulesetsResource;
     /** Publisher-managed import format resource */
     readonly importFormats: ImportFormatsResource;
     /** Publisher import job resource */
@@ -1667,4 +1806,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, type ConfirmScanUploadOptions, Connection, type CreateScanJobOptions, type CreateScanUploadSessionOptions, 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 DeckReadByExternalRefOptions, type DeckReadOptions, 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 GetGameRegionsOptions, type GetImportFormatByKeyOptions, type GetImportFormatOptions, type GetPublisherOptions, type GetRecordByDatasetIdentifierOptions, type GetRecordByIdentifierOptions, type GetRecordOptions, type GetRecordsByIdentifierOptions, type GetScanJobOptions, type GraphQLResponse, type HydrateDeckEntriesOptions, ImportFormatsResource, ImportsResource, type ListAppDecksOptions, type ListDatasetsOptions, type ListDeckApiApplicationAccessesOptions, type ListDeckCollaboratorsOptions, type ListDeckImportFormatsOptions, 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 ListScanTemplatesOptions, type ListViewerDecksOptions, type PollScanJobOptions, type PollSignal, type PreviewScanTemplateOptions, PublishersResource, RecordsResource, type ResolveScanTemplateOptions, RulesResource, type SaveScanTemplateOptions, type ScanMetricsOptions, ScanTemplatesResource, ScansResource, type SearchDatasetsOptions, type SearchGamesOptions, type SearchPublishersOptions, type SearchRecordsOptions, type UpdateScanTemplateOptions, type UploadFileInput, type VerifyWebhookSignatureInput, type WaitForExportJobOptions, type WaitForImportJobOptions, type WaitForRecordDeleteJobOptions, cacheKey, getRateLimitInfo, getSDKVersion, getUserAgent, readCache, writeCache };
+export { BaseResource, CardDBClient, Configuration, type ConfirmScanUploadOptions, Connection, type CreateScanJobOptions, type CreateScanUploadSessionOptions, 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 DeckReadByExternalRefOptions, type DeckReadOptions, 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 GetGameRegionsOptions, type GetImportFormatByKeyOptions, type GetImportFormatOptions, type GetPublisherOptions, type GetRecordByDatasetIdentifierOptions, type GetRecordByIdentifierOptions, type GetRecordOptions, type GetRecordsByIdentifierOptions, type GetRulesetByKeyOptions, type GetRulesetOptions, type GetScanJobOptions, type GraphQLResponse, type HydrateDeckEntriesOptions, ImportFormatsResource, ImportsResource, type ListAppDecksOptions, type ListDatasetsOptions, type ListDeckApiApplicationAccessesOptions, type ListDeckCollaboratorsOptions, type ListDeckImportFormatsOptions, type ListDeckVersionsOptions, type ListDecksOptions, type ListExportJobsOptions, type ListFormatsOptions, type ListGameImportJobsOptions, type ListGamesOptions, type ListImportFormatsOptions, type ListImportJobLogsOptions, type ListImportJobsOptions, type ListMyDeckApiApplicationAccessesOptions, type ListPublicDecksOptions, type ListPublicRulesetsOptions, type ListRecordDeleteJobsOptions, type ListRecordsOptions, type ListRuleDatasetsOptions, type ListRulesOptions, type ListRulesetVersionsOptions, type ListRulesetsOptions, type ListScanTemplatesOptions, type ListViewerDecksOptions, type PollScanJobOptions, type PollSignal, type PreviewScanTemplateOptions, PublishersResource, RecordsResource, type ResolveScanTemplateOptions, RulesResource, type RulesetValidationImpactOptions, type RulesetValidationRulesOptions, RulesetsResource, type SaveScanTemplateOptions, type ScanMetricsOptions, ScanTemplatesResource, ScansResource, type SearchDatasetsOptions, type SearchGamesOptions, type SearchPublishersOptions, type SearchRecordsOptions, type UpdateScanTemplateOptions, type UploadFileInput, type VerifyWebhookSignatureInput, type WaitForExportJobOptions, type WaitForImportJobOptions, type WaitForRecordDeleteJobOptions, cacheKey, getRateLimitInfo, getSDKVersion, getUserAgent, readCache, writeCache };

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, GameCreateInput, GameUpdateInput, GameScanRegion, Dataset, DatasetSchema, Deck, DeckReadState, DeckPublishedVersionSelector, ViewerDecksFilterInput, AppDecksFilterInput, PublicDecksFilterInput, DeckVersion, DeckDiff, DeckValidateInput, DeckValidation, DeckHydrateEntriesInput, DeckHydrateEntriesPayload, DeckExportFormat, DeckExportPayload, DeckSectionDefinition, DeckCollaborator, 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, DeckTokenIssuerCreateInput, DeckTokenIssuer, DeckAPIApplicationAccessGrantInput, DeckTokenExchangeInput, DeckTokenExchangePayload, 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, UploadPurpose, CreateScanUploadSessionInput, ConfirmScanUploadInput, CreateScanJobInput, ScanJobPayload, ScanJob, SubmitScanFeedbackInput, ScanFeedbackPayload, ScanMetricsInput, ScanMetrics, ResolveScanTemplateInput, ScanTemplateResolution, ScanTemplatesInput, ScanTemplate, SaveScanTemplateInput, ScanTemplatePayload, PreviewScanTemplateInput, ScanTemplatePreview, APIKeyInfo } from '@carddb/core';
+import { Logger, LogLevel, Cache, ResourceType, CardDBConfig, RateLimitInfo, GraphQLErrorInfo, Collection, Publisher, Game, GameCreateInput, GameUpdateInput, GameScanRegion, Dataset, DatasetSchema, DatasetFilterValueConnection, Deck, DeckReadState, DeckPublishedVersionSelector, ViewerDecksFilterInput, AppDecksFilterInput, PublicDecksFilterInput, DeckVersion, DeckDiff, DeckValidateInput, DeckValidation, DeckHydrateEntriesInput, DeckHydrateEntriesPayload, DeckExportFormat, DeckExportPayload, DeckSectionDefinition, DeckCollaborator, 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, DeckTokenIssuerCreateInput, DeckTokenIssuer, DeckAPIApplicationAccessGrantInput, DeckTokenExchangeInput, DeckTokenExchangePayload, HydrateDeckEntryInput, HydratedDeckEntry, FilterInput, DatasetRecord, DatasetRecordsUpsertInput, DatasetRecordsUpsertPayload, DatasetRecordsDeleteInput, DatasetRecordDeleteJob, DatasetRecordDeleteJobStatus, Ruleset, RulesetVersionStatus, RulesetVersion, DeckValidationRules, RulesetVersionDraftImportFromDatasetRecordInput, RulesetVersionDraftImportPreview, RulesetValidationImpact, RulesetCreateInput, RulesetUpdateInput, RulesetVersionDraftCreateInput, RulesetVersionDraftUpdateInput, RulesetVersionPublishInput, DatasetImportPreviewInput, DatasetImportPreviewResult, DatasetImportValidateInput, BulkImportResult, DatasetImportRunInput, ImportJob, ImportJobStatus, ImportLogLevel, ImportJobLog, GameImportPreviewInput, GameImportPreview, GameImportRunInput, GameImportJob, DatasetExportInput, ExportJob, ExportJobStatus, File, FileUploadInput, PresignedUpload, UploadPurpose, CreateScanUploadSessionInput, ConfirmScanUploadInput, CreateScanJobInput, ScanJobPayload, ScanJob, SubmitScanFeedbackInput, ScanFeedbackPayload, ScanMetricsInput, ScanMetrics, ResolveScanTemplateInput, ScanTemplateResolution, ScanTemplatesInput, ScanTemplate, SaveScanTemplateInput, ScanTemplatePayload, PreviewScanTemplateInput, ScanTemplatePreview, APIKeyInfo } from '@carddb/core';
 export * from '@carddb/core';
 
 /**
@@ -368,6 +368,16 @@ interface GetDatasetByKeyOptions extends GetDatasetOptions {
     /** Stable dataset key */
     datasetKey: string;
 }
+interface DatasetFilterValuesOptions extends GetDatasetOptions {
+    /** Optional case-insensitive search within values */
+    search?: string;
+    /** Include per-value record counts. More expensive than listing values only. */
+    includeCounts?: boolean;
+    /** Maximum number of values per field (default: 50, max: 500) */
+    first?: number;
+    /** Cursor for pagination. Applies to each requested field. */
+    after?: string;
+}
 declare class DatasetsResource extends BaseResource {
     constructor(connection: Connection, config: Configuration);
     /**
@@ -417,6 +427,20 @@ declare class DatasetsResource extends BaseResource {
      * const datasets = await client.datasets.getMany(['id1', 'id2', 'id3'])
      */
     getMany(ids: string[], options?: GetDatasetOptions): Promise<Dataset[]>;
+    /**
+     * Get distinct filter values for one or more filterable fields.
+     *
+     * @example
+     * const values = await client.datasets.filterValues('dataset-id', ['name', 'colors'], {
+     *   includeCounts: true,
+     *   first: 500,
+     * })
+     */
+    filterValues(id: string, fields: string[], options?: DatasetFilterValuesOptions): Promise<DatasetFilterValueConnection[]>;
+    /**
+     * Get distinct filter values for a dataset by publisher/game/dataset keys.
+     */
+    filterValues(publisherSlug: string, gameKey: string, datasetKey: string, fields: string[], options?: DatasetFilterValuesOptions): Promise<DatasetFilterValueConnection[]>;
 }
 
 /**
@@ -1080,6 +1104,119 @@ declare class RulesResource extends BaseResource {
     private searchRuleRecords;
 }
 
+/**
+ * First-class rulesets resource for CardDB API
+ */
+
+interface ListRulesetsOptions {
+    /** Include archived rulesets */
+    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;
+}
+type ListPublicRulesetsOptions = Omit<ListRulesetsOptions, 'includeArchived'>;
+interface GetRulesetOptions {
+    /** Whether to use cache (defaults to client config) */
+    cache?: boolean;
+}
+interface GetRulesetByKeyOptions extends GetRulesetOptions {
+    /** Game ID for stable ruleset-key lookup */
+    gameId: string;
+    /** Stable ruleset key */
+    key: string;
+}
+interface ListRulesetVersionsOptions extends GetRulesetOptions {
+    /** Optional status filter */
+    status?: RulesetVersionStatus;
+    /** Maximum number of results per page */
+    first?: number;
+    /** Cursor for pagination */
+    after?: string;
+}
+interface RulesetValidationRulesOptions extends GetRulesetOptions {
+    /** Optional immutable ruleset version override */
+    rulesetVersionId?: string;
+}
+interface RulesetValidationImpactOptions extends GetRulesetOptions {
+    /** Maximum number of affected decks to include */
+    first?: number;
+}
+declare class RulesetsResource extends BaseResource {
+    constructor(connection: Connection, config: Configuration);
+    /**
+     * List first-class rulesets for a game.
+     */
+    list(gameId: string, options?: ListRulesetsOptions): Promise<Collection<Ruleset>>;
+    /**
+     * List active public rulesets for a public game.
+     */
+    listPublic(gameId: string, options?: ListPublicRulesetsOptions): Promise<Collection<Ruleset>>;
+    /**
+     * Get one ruleset by UUID.
+     */
+    get(id: string, options?: GetRulesetOptions): Promise<Ruleset | null>;
+    /**
+     * Get one ruleset by game ID and stable key.
+     */
+    getByKey(options: GetRulesetByKeyOptions): Promise<Ruleset | null>;
+    /**
+     * List immutable versions for a ruleset.
+     */
+    versions(rulesetId: string, options?: ListRulesetVersionsOptions): Promise<Collection<RulesetVersion>>;
+    /**
+     * Get one immutable ruleset version by UUID.
+     */
+    getVersion(id: string, options?: GetRulesetOptions): Promise<RulesetVersion | null>;
+    /**
+     * Get the canonical active rules JSON for a ruleset.
+     */
+    validationRules(gameId: string, rulesetKey: string, options?: RulesetValidationRulesOptions): Promise<Record<string, unknown> | null>;
+    /**
+     * Get typed validation rules, including parsed deck sections.
+     */
+    deckValidationRules(gameId: string, rulesetKey: string, options?: RulesetValidationRulesOptions): Promise<DeckValidationRules | null>;
+    /**
+     * Preview compiling a legacy formats dataset record into a draft ruleset version.
+     */
+    previewImport(rulesetId: string, input: RulesetVersionDraftImportFromDatasetRecordInput): Promise<RulesetVersionDraftImportPreview>;
+    /**
+     * Preview validation impact for decks that use a ruleset version's parent ruleset.
+     */
+    validationImpact(rulesetVersionId: string, options?: RulesetValidationImpactOptions): Promise<RulesetValidationImpact>;
+    /**
+     * Create a first-class ruleset. Requires a server-side secret credential.
+     */
+    create(input: RulesetCreateInput): Promise<Ruleset>;
+    /**
+     * Update editable ruleset metadata. Requires a server-side secret credential.
+     */
+    update(id: string, input: RulesetUpdateInput): Promise<Ruleset>;
+    /**
+     * Create a draft ruleset version from an explicit canonical rules payload.
+     */
+    createDraft(rulesetId: string, input: RulesetVersionDraftCreateInput): Promise<RulesetVersion>;
+    /**
+     * Create a draft by compiling a legacy formats dataset record.
+     */
+    importDraftFromDatasetRecord(rulesetId: string, input: RulesetVersionDraftImportFromDatasetRecordInput): Promise<RulesetVersion>;
+    /**
+     * Update a draft ruleset version.
+     */
+    updateDraft(id: string, input: RulesetVersionDraftUpdateInput): Promise<RulesetVersion>;
+    /**
+     * Publish a draft and make it the current active ruleset version.
+     */
+    publishVersion(id: string, input?: RulesetVersionPublishInput): Promise<RulesetVersion>;
+    /**
+     * Activate an already-published version for rollback.
+     */
+    activateVersion(id: string): Promise<RulesetVersion>;
+}
+
 /**
  * Publisher-managed import format resource for CardDB API
  */
@@ -1574,6 +1711,8 @@ declare class CardDBClient {
     readonly decks: DecksResource;
     /** Rules resource for game rules and deck formats */
     readonly rules: RulesResource;
+    /** First-class rulesets resource for deck validation rules */
+    readonly rulesets: RulesetsResource;
     /** Publisher-managed import format resource */
     readonly importFormats: ImportFormatsResource;
     /** Publisher import job resource */
@@ -1667,4 +1806,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, type ConfirmScanUploadOptions, Connection, type CreateScanJobOptions, type CreateScanUploadSessionOptions, 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 DeckReadByExternalRefOptions, type DeckReadOptions, 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 GetGameRegionsOptions, type GetImportFormatByKeyOptions, type GetImportFormatOptions, type GetPublisherOptions, type GetRecordByDatasetIdentifierOptions, type GetRecordByIdentifierOptions, type GetRecordOptions, type GetRecordsByIdentifierOptions, type GetScanJobOptions, type GraphQLResponse, type HydrateDeckEntriesOptions, ImportFormatsResource, ImportsResource, type ListAppDecksOptions, type ListDatasetsOptions, type ListDeckApiApplicationAccessesOptions, type ListDeckCollaboratorsOptions, type ListDeckImportFormatsOptions, 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 ListScanTemplatesOptions, type ListViewerDecksOptions, type PollScanJobOptions, type PollSignal, type PreviewScanTemplateOptions, PublishersResource, RecordsResource, type ResolveScanTemplateOptions, RulesResource, type SaveScanTemplateOptions, type ScanMetricsOptions, ScanTemplatesResource, ScansResource, type SearchDatasetsOptions, type SearchGamesOptions, type SearchPublishersOptions, type SearchRecordsOptions, type UpdateScanTemplateOptions, type UploadFileInput, type VerifyWebhookSignatureInput, type WaitForExportJobOptions, type WaitForImportJobOptions, type WaitForRecordDeleteJobOptions, cacheKey, getRateLimitInfo, getSDKVersion, getUserAgent, readCache, writeCache };
+export { BaseResource, CardDBClient, Configuration, type ConfirmScanUploadOptions, Connection, type CreateScanJobOptions, type CreateScanUploadSessionOptions, 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 DeckReadByExternalRefOptions, type DeckReadOptions, 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 GetGameRegionsOptions, type GetImportFormatByKeyOptions, type GetImportFormatOptions, type GetPublisherOptions, type GetRecordByDatasetIdentifierOptions, type GetRecordByIdentifierOptions, type GetRecordOptions, type GetRecordsByIdentifierOptions, type GetRulesetByKeyOptions, type GetRulesetOptions, type GetScanJobOptions, type GraphQLResponse, type HydrateDeckEntriesOptions, ImportFormatsResource, ImportsResource, type ListAppDecksOptions, type ListDatasetsOptions, type ListDeckApiApplicationAccessesOptions, type ListDeckCollaboratorsOptions, type ListDeckImportFormatsOptions, type ListDeckVersionsOptions, type ListDecksOptions, type ListExportJobsOptions, type ListFormatsOptions, type ListGameImportJobsOptions, type ListGamesOptions, type ListImportFormatsOptions, type ListImportJobLogsOptions, type ListImportJobsOptions, type ListMyDeckApiApplicationAccessesOptions, type ListPublicDecksOptions, type ListPublicRulesetsOptions, type ListRecordDeleteJobsOptions, type ListRecordsOptions, type ListRuleDatasetsOptions, type ListRulesOptions, type ListRulesetVersionsOptions, type ListRulesetsOptions, type ListScanTemplatesOptions, type ListViewerDecksOptions, type PollScanJobOptions, type PollSignal, type PreviewScanTemplateOptions, PublishersResource, RecordsResource, type ResolveScanTemplateOptions, RulesResource, type RulesetValidationImpactOptions, type RulesetValidationRulesOptions, RulesetsResource, type SaveScanTemplateOptions, type ScanMetricsOptions, ScanTemplatesResource, ScansResource, type SearchDatasetsOptions, type SearchGamesOptions, type SearchPublishersOptions, type SearchRecordsOptions, type UpdateScanTemplateOptions, type UploadFileInput, type VerifyWebhookSignatureInput, type WaitForExportJobOptions, type WaitForImportJobOptions, type WaitForRecordDeleteJobOptions, cacheKey, getRateLimitInfo, getSDKVersion, getUserAgent, readCache, writeCache };