slate/scenes/SceneSettingsDeveloper.js

import * as React from "react";
import * as Actions from "~/common/actions";
import * as Window from "~/common/window";
import * as Constants from "~/common/constants";
import * as System from "~/components/system";
import * as SVG from "~/common/svg";
import * as Events from "~/common/custom-events";

import { css } from "@emotion/react";
import { TabGroup, PrimaryTabGroup, SecondaryTabGroup } from "~/components/core/TabGroup";
import { ConfirmationModal } from "~/components/core/ConfirmationModal";

import ScenePage from "~/components/core/ScenePage";
import ScenePageHeader from "~/components/core/ScenePageHeader";
import SquareButtonGray from "~/components/core/SquareButtonGray";

import APIDocsGetV1 from "~/components/api-docs/v1/get";
import APIDocsGetSlateV1 from "~/components/api-docs/v1/get-slate.js";
import APIDocsUpdateSlateV1 from "~/components/api-docs/v1/update-slate.js";
import APIDocsUploadToSlateV1 from "~/components/api-docs/v1/upload.js";

import APIDocsGetV2 from "~/components/api-docs/v2/get";
import APIDocsGetSlateV2 from "~/components/api-docs/v2/get-slate.js";
import APIDocsGetUserV2 from "~/components/api-docs/v2/get-user.js";
import APIDocsUpdateSlateV2 from "~/components/api-docs/v2/update-slate.js";
import APIDocsUpdateFileV2 from "~/components/api-docs/v2/update-file.js";
import APIDocsUploadToSlateV2 from "~/components/api-docs/v2/upload.js";
import APIDocsCreateLinkV2 from "~/components/api-docs/v2/create-link.js";
import APIDocsCreateCollectionV2 from "~/components/api-docs/v2/create-collection.js";
import APIDocsUploadByCidV2 from "~/components/api-docs/v2/upload-by-cid.js";
import APIDocsUploadByUrlV2 from "~/components/api-docs/v2/upload-by-url.js";
import WebsitePrototypeWrapper from "~/components/core/WebsitePrototypeWrapper";

const STYLES_API_KEY = css`
  height: 40px;
  border-radius: 4px;
  cursor: copy;
  background-color: ${Constants.semantic.bgLight};
  outline: none;
  border: none;
  width: 380px;
  font-family: ${Constants.font.code};
  padding: 0 16px;
  font-size: 14px;
`;

const STYLES_KEY_CONTAINER = css`
  height: 40px;
  display: flex;
  flex-direction: row;
  align-items: center;
  margin-bottom: 8px;
`;

const STYLES_EXAMPLE = css`
  margin-bottom: 48px;
`;

const STYLES_SECTION_HEADER = css`
  margin-top: 48px;
  margin-bottom: 24px;
`;

class Key extends React.Component {
  _input;

  state = { visible: false, copying: false, modalShow: false };

  _handleDelete = async (res, id) => {
    if (!res) {
      this.setState({ modalShow: false });
      return;
    }
    await this.props.onDelete(id);
    this.setState({ modalShow: false });
  };

  _handleCopy = async () => {
    this._input.select();
    document.execCommand("copy");
    await this.setState({ copying: true });
    await Window.delay(1000);
    await this.setState({ copying: false });
  };

  render() {
    return (
      <div css={STYLES_KEY_CONTAINER}>
        <input
          ref={(c) => {
            this._input = c;
          }}
          value={this.state.copying ? "Copied!" : this.props.data.key}
          readOnly
          type={this.state.visible || this.state.copying ? "text" : "password"}
          css={STYLES_API_KEY}
          onClick={this._handleCopy}
          onMouseEnter={() => this.setState({ visible: true })}
          onMouseLeave={() => this.setState({ visible: false })}
        />
        <SquareButtonGray
          onClick={() => this.setState({ modalShow: true })}
          style={{
            marginLeft: 8,
          }}
        >
          <SVG.Trash height="16px" />
        </SquareButtonGray>

        {this.state.modalShow && (
          <ConfirmationModal
            type={"DELETE"}
            withValidation={false}
            callback={(e) => this._handleDelete(e, this.props.data.id)}
            header={`Are you sure you want to revoke this API key?`}
            subHeader={`Any services using it will no longer be able to access your Slate account.`}
          />
        )}
      </div>
    );
  }
}

export default class SceneSettingsDeveloper extends React.Component {
  _bucketCID;

  state = {
    loading: false,
    language: "javascript",
    docs: "GET",
    copying: false,
    modalShow: false,
  };

  _handleCopy = async () => {
    this._bucketCID.select();
    document.execCommand("copy");
    await this.setState({ copying: true });
    await Window.delay(1000);
    await this.setState({ copying: false });
  };

  _handleSave = async (e) => {
    this.setState({ loading: true });

    const response = await Actions.generateAPIKey();

    Events.hasError(response);

    this.setState({ loading: false });
  };

  _handleDelete = async (id) => {
    this.setState({ loading: true, modalShow: false });

    const response = await Actions.deleteAPIKey({ id });

    Events.hasError(response);

    this.setState({ loading: false });
  };

  _handleChangeLanguage = (newLanguage) => {
    this.setState({ language: newLanguage });
  };

  render() {
    const tab = this.props.page.params?.tab || "v2";
    let APIKey = "YOUR-API-KEY-HERE";
    let lang = this.state.language;
    if (this.props.viewer.keys) {
      if (this.props.viewer.keys.length) {
        APIKey = this.props.viewer.keys[0].key;
      }
    }

    const userId = this.props.viewer.id;

    let slateId = "YOUR-SLATE-ID-VALUE";
    if (this.props.viewer.slates) {
      if (this.props.viewer.slates.length) {
        slateId = this.props.viewer.slates[0].id;
      }
    }

    let textileBucketCID = this.props.viewer?.textileBucketCID;

    return (
      <WebsitePrototypeWrapper
        title={`${this.props.page.pageTitle} • Slate`}
        url={`${Constants.hostname}${this.props.page.pathname}`}
      >
        <ScenePage>
          {/*
        <div css={STYLES_SIDEBAR}>
          <span css={STYLES_LINK} onClick={() => this._changeDocs("INTRO")}>
            Introduction
          </span>
          <span css={STYLES_LABEL}>api</span>
          <div>
            <span
              css={STYLES_LINK}
              style={{ color: this.state.docs === "GET" ? Constants.system.blue : null }}
              onClick={() => this._changeDocs("GET")}
            >
              Get all slates
            </span>
            <span
              css={STYLES_LINK}
              style={{ color: this.state.docs === "GET_SLATE" ? Constants.system.blue : null }}
              onClick={() => this._changeDocs("GET_SLATE")}
            >
              Get slate by ID
            </span>
            <span
              css={STYLES_LINK}
              style={{
                color: this.state.docs === "UPLOAD_TO_SLATE" ? Constants.system.blue : null,
              }}
              onClick={() => this._changeDocs("UPLOAD_TO_SLATE")}
            >
              Upload to slate by ID
            </span>
            <span
              css={STYLES_LINK}
              style={{ color: this.state.docs === "UPDATE_SLATE" ? Constants.system.blue : null }}
              onClick={() => this._changeDocs("UPDATE_SLATE")}
            >
              Update slate
            </span>
          </div>
          <span css={STYLES_LABEL}>guides</span>
        </div>
        */}
          <ScenePageHeader title="API Keys">
            You can use your API keys to access your account information outside of Slate and upload
            files to Slate. You can have a maximum of 10 keys at any given time.
          </ScenePageHeader>

          {textileBucketCID && (
            <div style={{ marginTop: 34, marginBottom: 24 }}>
              <System.DescriptionGroup
                style={{ maxWidth: 640 }}
                label="Bucket CID"
                description={
                  "This is your bucket CID. Use this to access your Slate files on other platforms"
                }
              />
              <input
                value={this.state.copying ? "Copied!" : textileBucketCID}
                css={STYLES_API_KEY}
                style={{ textOverflow: "ellipsis" }}
                type="text"
                readOnly
                ref={(c) => {
                  this._bucketCID = c;
                }}
                onClick={this._handleCopy}
              />
            </div>
          )}
          <br />

          <System.DescriptionGroup style={{ maxWidth: 640, marginBottom: 24 }} label="API Keys" />
          {this.props.viewer.keys.map((k) => {
            return <Key key={k.id} data={k} onDelete={this._handleDelete} />;
          })}

          <div style={{ marginTop: 24 }}>
            {this.props.viewer.keys.length < 10 ? (
              <System.ButtonPrimary onClick={this._handleSave} loading={this.state.loading}>
                Generate
              </System.ButtonPrimary>
            ) : (
              <System.ButtonDisabled>Generate</System.ButtonDisabled>
            )}
            {this.props.viewer.keys.length === 0 ? (
              <ScenePageHeader title="">
                Generate an API key to have it appear in the code examples
              </ScenePageHeader>
            ) : null}
          </div>

          {/*
        <div css={STYLES_LANGUAGE_CONTAINER}>
          <div
            css={STYLES_LANGUAGE_TILE}
            style={{ color: this.state.language === "javascript" ? Constants.system.blue : null }}
            onClick={() => this._handleChangeLanguage("javascript")}
          >
            <span style={{ marginBottom: 32 }}>JS ICON</span>
            <span>Node.js</span>
          </div>
          <div
            css={STYLES_LANGUAGE_TILE}
            style={{ color: this.state.language === "python" ? Constants.system.blue : null }}
            onClick={() => this._handleChangeLanguage("python")}
          >
            <span style={{ marginBottom: 32 }}>PY ICON</span>
            <span>Python3</span>
          </div>
        </div>

          <APIDocsGet language={lang} APIKey={APIKey} />
          <APIDocsUpdateSlate language={lang} APIKey={APIKey} slateId={slateId} />
          <APIDocsUploadToSlate language={lang} APIKey={APIKey} slateId={slateId} />
        */}
          <ScenePageHeader title="Developer Documentation" style={{ marginTop: 96 }}>
            Slate is currently on v2.0 of the API. While prior versions are still supported, we
            recommend using the most up to date version.
          </ScenePageHeader>

          <SecondaryTabGroup
            tabs={[
              { title: "Version 2.0", value: { tab: "v2" } },
              { title: "Version 1.0", value: { tab: "v1" } },
            ]}
            value={tab}
            onAction={this.props.onAction}
          />

          {tab === "v2" ? (
            <>
              <System.H2 css={STYLES_SECTION_HEADER}>Get</System.H2>
              <APIDocsGetV2
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                onLanguageChange={this._handleChangeLanguage}
              />
              <APIDocsGetSlateV2
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                slateId={slateId}
                onLanguageChange={this._handleChangeLanguage}
              />
              <APIDocsGetUserV2
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                userId={userId}
                onLanguageChange={this._handleChangeLanguage}
              />
              <System.H2 css={STYLES_SECTION_HEADER}>Update</System.H2>
              <APIDocsUpdateSlateV2
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                slateId={slateId}
                onLanguageChange={this._handleChangeLanguage}
              />
              <APIDocsUpdateFileV2
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                slateId={slateId}
                onLanguageChange={this._handleChangeLanguage}
              />
              <System.H2 css={STYLES_SECTION_HEADER}>Create</System.H2>
              <APIDocsCreateCollectionV2
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                slateId={slateId}
                onLanguageChange={this._handleChangeLanguage}
              />
              <APIDocsUploadToSlateV2
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                slateId={slateId}
                onLanguageChange={this._handleChangeLanguage}
              />
              <APIDocsUploadByCidV2
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                slateId={slateId}
                onLanguageChange={this._handleChangeLanguage}
              />
              <APIDocsUploadByUrlV2
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                slateId={slateId}
                onLanguageChange={this._handleChangeLanguage}
              />
              <APIDocsCreateLinkV2
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                slateId={slateId}
                onLanguageChange={this._handleChangeLanguage}
              />
            </>
          ) : (
            <>
              <System.H2 css={STYLES_SECTION_HEADER}>Read operations</System.H2>
              <APIDocsGetV1
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                onLanguageChange={this._handleChangeLanguage}
              />
              <APIDocsGetSlateV1
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                slateId={slateId}
                onLanguageChange={this._handleChangeLanguage}
              />
              <System.H2 css={STYLES_SECTION_HEADER}>Update operations</System.H2>
              <APIDocsUpdateSlateV1
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                slateId={slateId}
                onLanguageChange={this._handleChangeLanguage}
              />
              <System.H2 css={STYLES_SECTION_HEADER}>Create operations</System.H2>
              <APIDocsUploadToSlateV1
                cssValue={STYLES_EXAMPLE}
                language={lang}
                APIKey={APIKey}
                slateId={slateId}
                onLanguageChange={this._handleChangeLanguage}
              />
            </>
          )}
        </ScenePage>
      </WebsitePrototypeWrapper>
    );
  }
}