Initial commit

Author: elorzafe

.gitignore

@@ -0,0 +1,13 @@
+{
+     "version" : "2017-02-28",
+     "operation" : "PutItem",
+     "key" : {
+         "id" : { "S" : "${util.autoId()}" }
+     },
+     
+    #set( $attribs = $util.dynamodb.toMapValues($ctx.args) )
+    #set( $attribs.owner = $util.dynamodb.toDynamoDB($util.defaultIfNullOrBlank($context.identity.claims.username, $util.defaultIfNull($context.identity.username, 'ANON'))))
+    #set( $attribs.file = $util.dynamodb.toS3Object($ctx.args.file.key, $ctx.args.file.bucket, $ctx.args.file.region, $ctx.args.file.version))
+    #set( $attribs.createdAt = $util.dynamodb.toDynamoDB($util.time.nowISO8601()))
+	"attributeValues" : $util.toJson($attribs)
+}

AppSync/Mutation.addPicture.request

@@ -0,0 +1,4 @@
+{
+    "version": "2017-02-28",
+    "payload": {}
+}

AppSync/Picture.file.request

@@ -0,0 +1 @@
+$util.toJson($util.dynamodb.fromS3ObjectJson($context.source.file))

AppSync/Picture.file.response

@@ -0,0 +1,18 @@
+{
+  "version": "2017-02-28",
+  "operation": "Query",
+  "query": {
+    "expression": "#owner = :owner",
+    "expressionNames": {
+      "#owner": "owner",
+    },
+    "expressionValues": {
+      ":owner": {"S": "$util.defaultIfNull($context.identity.claims.username, $util.defaultIfNull($context.identity.username, 'ANON'))"},
+    },
+  },
+  "index": "owner-index",
+  "limit": $util.defaultIfNull($ctx.args.first, 20),
+  "nextToken": $util.toJson($util.defaultIfNullOrEmpty($ctx.args.after, null)),
+  "scanIndexForward": true,
+  "select": "ALL_ATTRIBUTES",
+}

AppSync/Query.listPictures.request

@@ -0,0 +1,41 @@
+type Mutation {
+	addPicture(name: String, visibility: Visibility, file: S3ObjectInput): Picture
+}
+
+type Picture {
+	id: ID!
+	name: String
+	visibility: Visibility
+	owner: String
+	file: S3Object
+	createdAt: String
+}
+
+type Query {
+	empty: Boolean
+}
+
+type S3Object {
+	bucket: String!
+	region: String!
+	key: String!
+}
+
+input S3ObjectInput {
+	bucket: String!
+	region: String!
+	localUri: String
+	visibility: Visibility
+	key: String
+	mimeType: String
+}
+
+enum Visibility {
+	public
+	private
+}
+
+schema {
+	query: Query
+	mutation: Mutation
+}

AppSync/schema.graphql

@@ -0,0 +1,4 @@
+## Code of Conduct
+This project has adopted the [Amazon Open Source Code of Conduct](https://aws.github.io/code-of-conduct). 
+For more information see the [Code of Conduct FAQ](https://aws.github.io/code-of-conduct-faq) or contact 
+opensource-codeofconduct@amazon.com with any additional questions or comments.

CODE_OF_CONDUCT.md

@@ -0,0 +1,61 @@
+# Contributing Guidelines
+
+Thank you for your interest in contributing to our project. Whether it's a bug report, new feature, correction, or additional 
+documentation, we greatly value feedback and contributions from our community.
+
+Please read through this document before submitting any issues or pull requests to ensure we have all the necessary 
+information to effectively respond to your bug report or contribution.
+
+
+## Reporting Bugs/Feature Requests
+
+We welcome you to use the GitHub issue tracker to report bugs or suggest features.
+
+When filing an issue, please check [existing open](https://github.com/aws-samples/aws-amplify-graphql/issues), or [recently closed](https://github.com/aws-samples/aws-amplify-graphql/issues?utf8=%E2%9C%93&q=is%3Aissue%20is%3Aclosed%20), issues to make sure somebody else hasn't already 
+reported the issue. Please try to include as much information as you can. Details like these are incredibly useful:
+
+* A reproducible test case or series of steps
+* The version of our code being used
+* Any modifications you've made relevant to the bug
+* Anything unusual about your environment or deployment
+
+
+## Contributing via Pull Requests
+Contributions via pull requests are much appreciated. Before sending us a pull request, please ensure that:
+
+1. You are working against the latest source on the *master* branch.
+2. You check existing open, and recently merged, pull requests to make sure someone else hasn't addressed the problem already.
+3. You open an issue to discuss any significant work - we would hate for your time to be wasted.
+
+To send us a pull request, please:
+
+1. Fork the repository.
+2. Modify the source; please focus on the specific change you are contributing. If you also reformat all the code, it will be hard for us to focus on your change.
+3. Ensure local tests pass.
+4. Commit to your fork using clear commit messages.
+5. Send us a pull request, answering any default questions in the pull request interface.
+6. Pay attention to any automated CI failures reported in the pull request, and stay involved in the conversation.
+
+GitHub provides additional document on [forking a repository](https://help.github.com/articles/fork-a-repo/) and 
+[creating a pull request](https://help.github.com/articles/creating-a-pull-request/).
+
+
+## Finding contributions to work on
+Looking at the existing issues is a great way to find something to contribute on. As our projects, by default, use the default GitHub issue labels ((enhancement/bug/duplicate/help wanted/invalid/question/wontfix), looking at any ['help wanted'](https://github.com/aws-samples/aws-amplify-graphql/labels/help%20wanted) issues is a great place to start. 
+
+
+## Code of Conduct
+This project has adopted the [Amazon Open Source Code of Conduct](https://aws.github.io/code-of-conduct). 
+For more information see the [Code of Conduct FAQ](https://aws.github.io/code-of-conduct-faq) or contact 
+opensource-codeofconduct@amazon.com with any additional questions or comments.
+
+
+## Security issue notifications
+If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our [vulnerability reporting page](http://aws.amazon.com/security/vulnerability-reporting/). Please do **not** create a public github issue.
+
+
+## Licensing
+
+See the [LICENSE](https://github.com/aws-samples/aws-amplify-graphql/blob/master/LICENSE) file for our project's licensing. We will ask you to confirm the licensing of your contribution.
+
+We may ask you to sign a [Contributor License Agreement (CLA)](http://en.wikipedia.org/wiki/Contributor_License_Agreement) for larger changes.

CONTRIBUTING.md

@@ -0,0 +1,96 @@
+Amazon Software License 1.0
+
+This Amazon Software License ("License") governs your use, reproduction, and
+distribution of the accompanying software as specified below.
+
+1. Definitions
+
+  "Licensor" means any person or entity that distributes its Work.
+
+  "Software" means the original work of authorship made available under this
+  License.
+
+  "Work" means the Software and any additions to or derivative works of the
+  Software that are made available under this License.
+
+  The terms "reproduce," "reproduction," "derivative works," and
+  "distribution" have the meaning as provided under U.S. copyright law;
+  provided, however, that for the purposes of this License, derivative works
+  shall not include works that remain separable from, or merely link (or bind
+  by name) to the interfaces of, the Work.
+
+  Works, including the Software, are "made available" under this License by
+  including in or with the Work either (a) a copyright notice referencing the
+  applicability of this License to the Work, or (b) a copy of this License.
+
+2. License Grants
+
+  2.1 Copyright Grant. Subject to the terms and conditions of this License,
+  each Licensor grants to you a perpetual, worldwide, non-exclusive,
+  royalty-free, copyright license to reproduce, prepare derivative works of,
+  publicly display, publicly perform, sublicense and distribute its Work and
+  any resulting derivative works in any form.
+
+  2.2 Patent Grant. Subject to the terms and conditions of this License, each
+  Licensor grants to you a perpetual, worldwide, non-exclusive, royalty-free
+  patent license to make, have made, use, sell, offer for sale, import, and
+  otherwise transfer its Work, in whole or in part. The foregoing license
+  applies only to the patent claims licensable by Licensor that would be
+  infringed by Licensor's Work (or portion thereof) individually and
+  excluding any combinations with any other materials or technology.
+
+3. Limitations
+
+  3.1 Redistribution. You may reproduce or distribute the Work only if
+  (a) you do so under this License, (b) you include a complete copy of this
+  License with your distribution, and (c) you retain without modification
+  any copyright, patent, trademark, or attribution notices that are present
+  in the Work.
+
+  3.2 Derivative Works. You may specify that additional or different terms
+  apply to the use, reproduction, and distribution of your derivative works
+  of the Work ("Your Terms") only if (a) Your Terms provide that the use
+  limitation in Section 3.3 applies to your derivative works, and (b) you
+  identify the specific derivative works that are subject to Your Terms.
+  Notwithstanding Your Terms, this License (including the redistribution
+  requirements in Section 3.1) will continue to apply to the Work itself.
+
+  3.3 Use Limitation. The Work and any derivative works thereof only may be
+  used or intended for use with the web services, computing platforms or
+  applications provided by Amazon.com, Inc. or its affiliates, including
+  Amazon Web Services, Inc.
+
+  3.4 Patent Claims. If you bring or threaten to bring a patent claim against
+  any Licensor (including any claim, cross-claim or counterclaim in a
+  lawsuit) to enforce any patents that you allege are infringed by any Work,
+  then your rights under this License from such Licensor (including the
+  grants in Sections 2.1 and 2.2) will terminate immediately.
+
+  3.5 Trademarks. This License does not grant any rights to use any
+  Licensor's or its affiliates' names, logos, or trademarks, except as
+  necessary to reproduce the notices described in this License.
+
+  3.6 Termination. If you violate any term of this License, then your rights
+  under this License (including the grants in Sections 2.1 and 2.2) will
+  terminate immediately.
+
+4. Disclaimer of Warranty.
+
+  THE WORK IS PROVIDED "AS IS" WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
+  EITHER EXPRESS OR IMPLIED, INCLUDING WARRANTIES OR CONDITIONS OF
+  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE OR
+  NON-INFRINGEMENT. YOU BEAR THE RISK OF UNDERTAKING ANY ACTIVITIES UNDER
+  THIS LICENSE. SOME STATES' CONSUMER LAWS DO NOT ALLOW EXCLUSION OF AN
+  IMPLIED WARRANTY, SO THIS DISCLAIMER MAY NOT APPLY TO YOU.
+
+5. Limitation of Liability.
+
+  EXCEPT AS PROHIBITED BY APPLICABLE LAW, IN NO EVENT AND UNDER NO LEGAL
+  THEORY, WHETHER IN TORT (INCLUDING NEGLIGENCE), CONTRACT, OR OTHERWISE
+  SHALL ANY LICENSOR BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY DIRECT,
+  INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR
+  RELATED TO THIS LICENSE, THE USE OR INABILITY TO USE THE WORK (INCLUDING
+  BUT NOT LIMITED TO LOSS OF GOODWILL, BUSINESS INTERRUPTION, LOST PROFITS
+  OR DATA, COMPUTER FAILURE OR MALFUNCTION, OR ANY OTHER COMM ERCIAL DAMAGES
+  OR LOSSES), EVEN IF THE LICENSOR HAS BEEN ADVISED OF THE POSSIBILITY OF
+  SUCH DAMAGES.

LICENSE

@@ -0,0 +1,2 @@
+AWS Amplify for with GraphQL sample
+Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved. 

NOTICE

@@ -0,0 +1,70 @@
+# AWS AppSync GraphQL Photo Sample
+
+![Demo](media/demo.gif)
+
+This sample application shows how to use GraphQL to build an application that a user can login to the system, then upload and download photos which are private to them. The sample is written in React and uses AWS AppSync, Amazon Cognito, Amazon DynamoDB and Amazon S3 as well as the AWS Mobile CLI.
+
+## Architecture Overview
+![Architecture](media/architecture_diagram.png)
+
+## Prerequisites
++ [AWS Account](https://aws.amazon.com/mobile/details/)
+
++ [NodeJS](https://nodejs.org/en/download/) with [NPM](https://docs.npmjs.com/getting-started/installing-node)
+
++ [AWS Mobile CLI](https://github.com/aws/awsmobile-cli)
+  - `npm install -g awsmobile-cli`
+
+
+## Getting Started
+1. Clone this repo locally.
+
+2. Navigate to the [AWS AppSync Console](https://us-east-2.console.aws.amazon.com/appsync/home). Select **Create API** with a name of **Pictures**, select **Custom Schema** and click **Create**.
+
+3. Click **Schema** navigation on the left. Copy the contents of `./AppSync/schema.graphql` into the console editor and press **Save**. 
+
+4. Still on the Schema page, press **Create Resources** in the upper right corner.
+  - Select the **Picture** type from the drop down. 
+  - Then click on **Additional Indexes** followed by **Add Index**, set the index name as **owner-index** with Primary key as **owner** and sort key as **id**.
+  - And finally click **Create** at the bottom.
+
+    This will create DynamoDB tables, some default queries/mutations and connect them to Resolvers
+
+5. Click the **Attach** button next to `addPicture` on the right of the schema editor and select **PictureTable** as the data source. For the request mapping template use the code in `./AppSync/Mutation.addPicture.request` and for the response mapping template select **Return single item** from the drop-down. Press **Save** at the bottom.
+
+6. Click the **Data Sources** navigation on the left, select **New** and create a data source with **None** as the type with a name of **Local**. 
+
+7. Go back to the Schema page and on the right hand side under the **Picture** type click the **Attach** button next to the `file:S3Object` field and select the **Local** data source that you just created. For the request mapping template use the code in `./AppSync/Picture.file.request` and for the response mapping template use `./AppSync/Picture.file.response`. Press **Save** at the bottom.
+
+8. Navigate to the Schema page again and on the right hand side find `listPictures(...):[PictureConnection]` under the Query type and click the resolver to edit it.  Update the **REQUEST** mapping template with the code in `./AppSync/Query.listPictures.request`. Use "Return single item" as the response template. Press **Save** at the bottom.
+    - This will use fine grained authorization controls to filter GraphQL responses so that users only see their data from DynamoDB.
+
+9. Now use the [awsmobile-cli](https://github.com/aws/awsmobile-cli) to create your Amazon Cognito User Pool and Identity Pool, as well as an Amazon S3 bucket with private directories to store each user's photo:
+
+```
+cd ./photo-client
+awsmobile init --yes
+awsmobile user-signin enable
+awsmobile user-files enable
+awsmobile push
+```
+
+This process will configure all the per-user security settings when users register and login to your application, and automatically download the configuration file to `./photo-client/src/aws-exports.js`. The sample uses [AWS Amplify](https://github.com/aws/aws-amplify) to perform the Sign-Up and Sign-In flows with a Higher Order Component.
+
+10. On AppSync console, click the **Settings** tab on the left and select **Amazon Cognito User Pool** as the _Authorization Type_. 
+  - Select user pool region
+  - Select the user pool (You can type **photo** and that will filter the user pool)
+  - Set default action **ALLOW**
+  - Click **Save**.
+
+11. On the left navigation of the AppSync console, select the root of your API (called **Pictures**) and scroll down to the bottom where **Web** is listed. Click the **Download** button and save the `AppSync.js` file into the `./photo-client/src` directory.
+
+
+12. Finally in a terminal navigate to your cloned repo and run the application:
+
+```
+cd ./photo-client
+yarn start
+```
+
+If the application runs successfully you should be able to enter the name of a photo, choose a file and then press **Add photo**. This will make a GraphQL call to enter the record into the database and simultaneously upload the object to S3. An immediate fetch of the record will then be at the bottom of the screen.

README.md

@@ -0,0 +1,26 @@
+{
+  "name": "photo-client",
+  "version": "0.1.0",
+  "private": true,
+  "dependencies": {
+    "aws-amplify": "^0.2.9",
+    "aws-amplify-react": "^0.1.34",
+    "aws-appsync": "^1.0.11",
+    "aws-appsync-react": "^1.0.5",
+    "aws-sdk": "^2.177.0",
+    "graphql-tag": "^2.6.1",
+    "react": "^16.2.0",
+    "react-apollo": "^2.0.4",
+    "react-dom": "^16.2.0",
+    "react-scripts": "1.0.17",
+    "semantic-ui-css": "^2.2.14",
+    "semantic-ui-react": "^0.78.2",
+    "uuid": "^3.1.0"
+  },
+  "scripts": {
+    "start": "react-scripts start",
+    "build": "react-scripts build",
+    "test": "react-scripts test --env=jsdom",
+    "eject": "react-scripts eject"
+  }
+}

media/architecture_diagram.png

@@ -0,0 +1,40 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
+    <meta name="theme-color" content="#000000">
+    <!--
+      manifest.json provides metadata used when your web app is added to the
+      homescreen on Android. See https://developers.google.com/web/fundamentals/engage-and-retain/web-app-manifest/
+    -->
+    <link rel="manifest" href="%PUBLIC_URL%/manifest.json">
+    <link rel="shortcut icon" href="%PUBLIC_URL%/favicon.ico">
+    <!--
+      Notice the use of %PUBLIC_URL% in the tags above.
+      It will be replaced with the URL of the `public` folder during the build.
+      Only files inside the `public` folder can be referenced from the HTML.
+
+      Unlike "/favicon.ico" or "favicon.ico", "%PUBLIC_URL%/favicon.ico" will
+      work correctly both with client-side routing and a non-root public URL.
+      Learn how to configure a non-root public URL by running `npm run build`.
+    -->
+    <title>React App</title>
+  </head>
+  <body>
+    <noscript>
+      You need to enable JavaScript to run this app.
+    </noscript>
+    <div id="root"></div>
+    <!--
+      This HTML file is a template.
+      If you open it directly in the browser, you will see an empty page.
+
+      You can add webfonts, meta tags, or analytics to this file.
+      The build step will place the bundled scripts into the <body> tag.
+
+      To begin the development, run `npm start` or `yarn start`.
+      To create a production bundle, use `npm run build` or `yarn build`.
+    -->
+  </body>
+</html>