@carddb/client 0.4.1 → 0.4.5

package/dist/index.cjs

@@ -921,14 +921,27 @@ var DecksResource = class extends BaseResource {
   /**
    * Fetch a deck by UUID using the ownership-aware `deck` API.
    */
-  async get(id, options = {}) {
-    const key = this.cacheKey("decks", "get", { id });
+  async get(id, options) {
+    const variables = core.QueryBuilder.deckReadVariables(id, options.readState, options.version);
+    const key = this.cacheKey("decks", "get", variables);
     return this.withCache(key, "decks", options, async () => {
       const { query } = core.QueryBuilder.deckById();
-      const result = await this.connection.execute(query, { id });
+      const result = await this.connection.execute(query, variables);
       return result["deck"] ?? null;
     });
   }
+  /**
+   * Fetch mutable draft data for a deck by UUID.
+   */
+  async getDraft(id, options = {}) {
+    return this.get(id, { ...options, readState: "DRAFT" });
+  }
+  /**
+   * Fetch immutable published data for a deck by UUID.
+   */
+  async getPublished(id, options = {}) {
+    return this.get(id, { ...options, readState: "PUBLISHED", version: options.version });
+  }
   /**
    * Fetch one deck owned by the current account or API application.
    */
@@ -976,14 +989,35 @@ var DecksResource = class extends BaseResource {
   /**
    * Fetch by external reference using the ownership-aware `deckByExternalRef` API.
    */
-  async getByExternalRef(externalRef, options = {}) {
-    const key = this.cacheKey("decks", "getByExternalRef", { externalRef });
+  async getByExternalRef(externalRef, options) {
+    const variables = core.QueryBuilder.deckExternalRefReadVariables(
+      externalRef,
+      options.readState,
+      options.version
+    );
+    const key = this.cacheKey("decks", "getByExternalRef", variables);
     return this.withCache(key, "decks", options, async () => {
       const { query } = core.QueryBuilder.deckByExternalRef();
-      const result = await this.connection.execute(query, { externalRef });
+      const result = await this.connection.execute(query, variables);
       return result["deckByExternalRef"] ?? null;
     });
   }
+  /**
+   * Fetch mutable draft data by API-application external reference.
+   */
+  async getDraftByExternalRef(externalRef, options = {}) {
+    return this.getByExternalRef(externalRef, { ...options, readState: "DRAFT" });
+  }
+  /**
+   * Fetch immutable published data by API-application external reference.
+   */
+  async getPublishedByExternalRef(externalRef, options = {}) {
+    return this.getByExternalRef(externalRef, {
+      ...options,
+      readState: "PUBLISHED",
+      version: options.version
+    });
+  }
   /**
    * List decks owned by the current account or API application.
    */
@@ -1086,39 +1120,6 @@ var DecksResource = class extends BaseResource {
       nextPageLoader: async (cursor) => this.listVersions(deckId, { ...options, after: cursor })
     });
   }
-  /**
-   * Fetch current draft data using a revocable preview token.
-   */
-  async preview(token, options = {}) {
-    const key = this.cacheKey("decks", "preview", { token });
-    return this.withCache(key, "decks", options, async () => {
-      const { query } = core.QueryBuilder.deckPreview();
-      const result = await this.connection.execute(query, { token });
-      return result["deckPreview"] ?? null;
-    });
-  }
-  /**
-   * Fetch published embed data using a revocable embed token.
-   */
-  async embed(token, options = {}) {
-    const key = this.cacheKey("decks", "embed", { token });
-    return this.withCache(key, "decks", options, async () => {
-      const { query } = core.QueryBuilder.deckEmbed();
-      const result = await this.connection.execute(query, { token });
-      return result["deckEmbed"] ?? null;
-    });
-  }
-  /**
-   * Fetch token-authorized published data using an exchanged access token.
-   */
-  async access(token, options = {}) {
-    const key = this.cacheKey("decks", "access", { token });
-    return this.withCache(key, "decks", options, async () => {
-      const { query } = core.QueryBuilder.deckAccess();
-      const result = await this.connection.execute(query, { token });
-      return result["deckAccess"] ?? null;
-    });
-  }
   /**
    * Compare the current draft against the latest published version.
    */
@@ -1206,39 +1207,6 @@ var DecksResource = class extends BaseResource {
       return result["deckCollaborators"];
     });
   }
-  /**
-   * List draft preview tokens for a deck.
-   */
-  async listPreviewTokens(deckId, options = {}) {
-    const key = this.cacheKey("decks", "listPreviewTokens", { deckId });
-    return this.withCache(key, "decks", options, async () => {
-      const { query } = core.QueryBuilder.deckPreviewTokens();
-      const result = await this.connection.execute(query, { deckId });
-      return result["deckPreviewTokens"];
-    });
-  }
-  /**
-   * List published embed tokens for a deck.
-   */
-  async listEmbedTokens(deckId, options = {}) {
-    const key = this.cacheKey("decks", "listEmbedTokens", { deckId });
-    return this.withCache(key, "decks", options, async () => {
-      const { query } = core.QueryBuilder.deckEmbedTokens();
-      const result = await this.connection.execute(query, { deckId });
-      return result["deckEmbedTokens"];
-    });
-  }
-  /**
-   * List trusted access token issuers for a deck.
-   */
-  async listAccessTokenIssuers(deckId, options = {}) {
-    const key = this.cacheKey("decks", "listAccessTokenIssuers", { deckId });
-    return this.withCache(key, "decks", options, async () => {
-      const { query } = core.QueryBuilder.deckAccessTokenIssuers();
-      const result = await this.connection.execute(query, { deckId });
-      return result["deckAccessTokenIssuers"];
-    });
-  }
   /**
    * List API applications with explicit access to one owned deck.
    */
@@ -1523,63 +1491,32 @@ var DecksResource = class extends BaseResource {
     return Boolean(result["deckCollaboratorRemove"]);
   }
   /**
-   * Create a revocable draft preview token.
-   */
-  async createPreviewToken(input) {
-    const { query } = core.QueryBuilder.createDeckPreviewToken();
-    const variables = core.QueryBuilder.deckPreviewTokenCreateVariables(input);
-    const result = await this.connection.execute(query, variables);
-    return result["deckPreviewTokenCreate"];
-  }
-  /**
-   * Revoke a draft preview token.
-   */
-  async revokePreviewToken(id) {
-    const { query } = core.QueryBuilder.revokeDeckPreviewToken();
-    const result = await this.connection.execute(query, { id });
-    return Boolean(result["deckPreviewTokenRevoke"]);
-  }
-  /**
-   * Create a revocable published embed token.
-   */
-  async createEmbedToken(input) {
-    const { query } = core.QueryBuilder.createDeckEmbedToken();
-    const variables = core.QueryBuilder.deckEmbedTokenCreateVariables(input);
-    const result = await this.connection.execute(query, variables);
-    return result["deckEmbedTokenCreate"];
-  }
-  /**
-   * Revoke a published embed token.
-   */
-  async revokeEmbedToken(id) {
-    const { query } = core.QueryBuilder.revokeDeckEmbedToken();
-    const result = await this.connection.execute(query, { id });
-    return Boolean(result["deckEmbedTokenRevoke"]);
-  }
-  /**
-   * Trust the current API application to exchange short-lived deck access tokens.
+   * Create a unified deck token issuer for the current secret-key API application.
    */
-  async createAccessTokenIssuer(input) {
-    const { query } = core.QueryBuilder.createDeckAccessTokenIssuer();
-    const variables = core.QueryBuilder.deckAccessTokenIssuerCreateVariables(input);
+  async createTokenIssuer(input) {
+    this.config.requireSecretCredential("decks.createTokenIssuer");
+    const { query } = core.QueryBuilder.createDeckTokenIssuer();
+    const variables = core.QueryBuilder.deckTokenIssuerCreateVariables(input);
     const result = await this.connection.execute(query, variables);
-    return result["deckAccessTokenIssuerCreate"];
+    return result["deckTokenIssuerCreate"];
   }
   /**
-   * Revoke a trusted deck access token issuer.
+   * Revoke a unified deck token issuer.
    */
-  async revokeAccessTokenIssuer(id) {
-    const { query } = core.QueryBuilder.revokeDeckAccessTokenIssuer();
+  async revokeTokenIssuer(id) {
+    this.config.requireSecretCredential("decks.revokeTokenIssuer");
+    const { query } = core.QueryBuilder.revokeDeckTokenIssuer();
     const result = await this.connection.execute(query, { id });
-    return Boolean(result["deckAccessTokenIssuerRevoke"]);
+    return Boolean(result["deckTokenIssuerRevoke"]);
   }
   /**
-   * Revoke only the direct signing key for a trusted deck access token issuer.
+   * Revoke only the direct signing key for a unified deck token issuer.
    */
-  async revokeAccessTokenIssuerSigningKey(id) {
-    const { query } = core.QueryBuilder.revokeDeckAccessTokenIssuerSigningKey();
+  async revokeTokenIssuerSigningKey(id) {
+    this.config.requireSecretCredential("decks.revokeTokenIssuerSigningKey");
+    const { query } = core.QueryBuilder.revokeDeckTokenIssuerSigningKey();
     const result = await this.connection.execute(query, { id });
-    return result["deckAccessTokenIssuerSigningKeyRevoke"];
+    return result["deckTokenIssuerSigningKeyRevoke"];
   }
   /**
    * Grant or update one OAuth app's selected-deck access.
@@ -1600,33 +1537,23 @@ var DecksResource = class extends BaseResource {
     return Boolean(result["deckApiApplicationAccessRevoke"]);
   }
   /**
-   * Exchange the current trusted API application credential for a deck access token.
-   */
-  async exchangeAccessToken(input) {
-    this.config.requireSecretCredential("decks.exchangeAccessToken");
-    const { query } = core.QueryBuilder.exchangeDeckAccessToken();
-    const variables = core.QueryBuilder.deckAccessTokenExchangeVariables(input);
-    const result = await this.connection.execute(query, variables);
-    return result["deckAccessTokenExchange"];
-  }
-  /**
-   * Exchange the current secret API application credential for an app-owned deck session token.
+   * Exchange the current secret API application credential for a unified deck token.
    */
-  async exchangeSessionToken(input) {
-    this.config.requireSecretCredential("decks.exchangeSessionToken");
-    const { query } = core.QueryBuilder.exchangeDeckSessionToken();
-    const variables = core.QueryBuilder.deckSessionTokenExchangeVariables(input);
+  async exchangeToken(input) {
+    this.config.requireSecretCredential("decks.exchangeToken");
+    const { query } = core.QueryBuilder.exchangeDeckToken();
+    const variables = core.QueryBuilder.deckTokenExchangeVariables(input);
     const result = await this.connection.execute(query, variables);
-    return result["deckSessionTokenExchange"];
+    return result["deckTokenExchange"];
   }
   /**
-   * Revoke an exchanged deck access token.
+   * Revoke an exchanged unified deck token.
    */
-  async revokeAccessToken(id) {
-    this.config.requireSecretCredential("decks.revokeAccessToken");
-    const { query } = core.QueryBuilder.revokeDeckAccessToken();
+  async revokeToken(id) {
+    this.config.requireSecretCredential("decks.revokeToken");
+    const { query } = core.QueryBuilder.revokeDeckToken();
     const result = await this.connection.execute(query, { id });
-    return Boolean(result["deckAccessTokenRevoke"]);
+    return Boolean(result["deckTokenRevoke"]);
   }
   /**
    * Hydrate third-party-owned deck entries without storing them in CardDB.