@canva/cli 0.0.1-beta.3 → 0.0.1-beta.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +177 -109
- package/cli.js +267 -267
- package/package.json +1 -1
- package/templates/base/eslint.config.mjs +0 -2
- package/templates/base/package.json +22 -19
- package/templates/common/.gitignore.template +5 -6
- package/templates/common/README.md +4 -7
- package/templates/common/conf/eslint-general.mjs +26 -0
- package/templates/common/conf/eslint-i18n.mjs +18 -3
- package/templates/dam/package.json +23 -23
- package/templates/gen_ai/README.md +1 -40
- package/templates/gen_ai/backend/routers/image.ts +3 -3
- package/templates/gen_ai/backend/server.ts +0 -7
- package/templates/gen_ai/eslint.config.mjs +0 -2
- package/templates/gen_ai/package.json +24 -24
- package/templates/gen_ai/src/api/api.ts +24 -79
- package/templates/gen_ai/src/components/footer.messages.ts +0 -5
- package/templates/gen_ai/src/components/footer.tsx +7 -25
- package/templates/gen_ai/src/components/index.ts +0 -1
- package/templates/gen_ai/src/components/loading_results.tsx +4 -8
- package/templates/gen_ai/src/context/app_context.tsx +5 -33
- package/templates/gen_ai/src/context/context.messages.ts +1 -12
- package/templates/hello_world/eslint.config.mjs +0 -2
- package/templates/hello_world/package.json +18 -18
- package/templates/gen_ai/backend/routers/oauth.ts +0 -393
- package/templates/gen_ai/src/components/logged_in_status.tsx +0 -44
- package/templates/gen_ai/src/services/auth.tsx +0 -26
- package/templates/gen_ai/src/services/index.ts +0 -1
|
@@ -1,393 +0,0 @@
|
|
|
1
|
-
import * as crypto from "crypto";
|
|
2
|
-
import "dotenv/config";
|
|
3
|
-
import * as express from "express";
|
|
4
|
-
import * as basicAuth from "express-basic-auth";
|
|
5
|
-
import { JSONFileDatabase } from "../database/database";
|
|
6
|
-
import { createBearerMiddleware } from "../../utils/backend/bearer_middleware";
|
|
7
|
-
import * as debug from "debug";
|
|
8
|
-
|
|
9
|
-
/**
|
|
10
|
-
* Prefix your start command with `DEBUG=express:route:oauth` to enable debug logging
|
|
11
|
-
* for this middleware
|
|
12
|
-
*/
|
|
13
|
-
const debugLogger = debug("express:route:oauth");
|
|
14
|
-
|
|
15
|
-
/**
|
|
16
|
-
* These are the hard-coded credentials for logging in to this template.
|
|
17
|
-
*/
|
|
18
|
-
const USERNAME = "username";
|
|
19
|
-
const PASSWORD = "password";
|
|
20
|
-
|
|
21
|
-
const COOKIE_EXPIRY_MS = 5 * 60 * 1000; // 5 minutes
|
|
22
|
-
const TOKEN_EXPIRY_S = 4 * 60 * 60; // 4 hours
|
|
23
|
-
const REFRESH_EXPIRY_S = 30 * 24 * 3600; // 30 days
|
|
24
|
-
|
|
25
|
-
const CLIENT_ID = "client_id";
|
|
26
|
-
const CLIENT_SECRET = "client_secret";
|
|
27
|
-
const REDIRECT_URI = "https://www.canva.com/apps/oauth/authorized";
|
|
28
|
-
|
|
29
|
-
/**
|
|
30
|
-
* For simplicity, we simply generate random token values and store them in our database
|
|
31
|
-
* for production you may want to use JWTs or other stateless methods.
|
|
32
|
-
*/
|
|
33
|
-
interface Token {
|
|
34
|
-
value: string;
|
|
35
|
-
expiry: number; // Unix timestamp
|
|
36
|
-
}
|
|
37
|
-
|
|
38
|
-
export interface User {
|
|
39
|
-
id: string;
|
|
40
|
-
authorizationCode?: Token;
|
|
41
|
-
accessToken?: Token;
|
|
42
|
-
refreshToken?: Token;
|
|
43
|
-
}
|
|
44
|
-
|
|
45
|
-
interface RedirectUriRecord {
|
|
46
|
-
redirectUri: string;
|
|
47
|
-
authorizationCode: string;
|
|
48
|
-
}
|
|
49
|
-
|
|
50
|
-
export interface Data {
|
|
51
|
-
users: User[];
|
|
52
|
-
redirect_uris: RedirectUriRecord[];
|
|
53
|
-
}
|
|
54
|
-
|
|
55
|
-
/**
|
|
56
|
-
* For more information on Authentication, refer to our documentation: {@link https://www.canva.dev/docs/apps/authenticating-users/#types-of-authentication}.
|
|
57
|
-
*/
|
|
58
|
-
export const createAuthRouter = () => {
|
|
59
|
-
/**
|
|
60
|
-
* Set up a database with a "users" table. In this example code, the
|
|
61
|
-
* database is simply a JSON file.
|
|
62
|
-
*/
|
|
63
|
-
const db = new JSONFileDatabase<Data>({ users: [], redirect_uris: [] });
|
|
64
|
-
|
|
65
|
-
const router = express.Router();
|
|
66
|
-
|
|
67
|
-
/**
|
|
68
|
-
* The urlencoded middleware allows us to parse form data from the request body.
|
|
69
|
-
* This is required for the OAuth 2.0 Token Exchange endpoint.
|
|
70
|
-
*/
|
|
71
|
-
router.use(express.urlencoded({ extended: true }));
|
|
72
|
-
|
|
73
|
-
/**
|
|
74
|
-
* This is the OAuth 2.0 Authorization endpoint
|
|
75
|
-
* https://datatracker.ietf.org/doc/html/rfc6749#section-3.1
|
|
76
|
-
*
|
|
77
|
-
* This endpoint does not implement PKCE, which you would want to do
|
|
78
|
-
* for production.
|
|
79
|
-
*/
|
|
80
|
-
router.get(
|
|
81
|
-
"/auth/authorize",
|
|
82
|
-
basicAuth({
|
|
83
|
-
users: { [USERNAME]: PASSWORD },
|
|
84
|
-
challenge: true,
|
|
85
|
-
}),
|
|
86
|
-
async (req, res) => {
|
|
87
|
-
const redirectUri = decodeURIComponent(
|
|
88
|
-
req.query.redirect_uri?.toString() ?? REDIRECT_URI,
|
|
89
|
-
);
|
|
90
|
-
const clientId = req.query.client_id?.toString();
|
|
91
|
-
const responseType = req.query.response_type?.toString();
|
|
92
|
-
const state = req.query.state?.toString();
|
|
93
|
-
|
|
94
|
-
if (!clientId) {
|
|
95
|
-
return res.status(400).send("Missing required client ID parameter");
|
|
96
|
-
}
|
|
97
|
-
|
|
98
|
-
if (clientId !== CLIENT_ID) {
|
|
99
|
-
return res.status(400).send("Invalid client ID");
|
|
100
|
-
}
|
|
101
|
-
|
|
102
|
-
if (redirectUri !== REDIRECT_URI) {
|
|
103
|
-
return res.status(400).send(`Invalid redirect URI ${redirectUri}`);
|
|
104
|
-
}
|
|
105
|
-
|
|
106
|
-
const failureResponse = (error: string) => {
|
|
107
|
-
const params = new URLSearchParams({
|
|
108
|
-
error,
|
|
109
|
-
state: state || "",
|
|
110
|
-
});
|
|
111
|
-
res.redirect(302, `${redirectUri}?${params}`);
|
|
112
|
-
};
|
|
113
|
-
|
|
114
|
-
if (responseType !== "code") {
|
|
115
|
-
return failureResponse("unsupported_response_type");
|
|
116
|
-
}
|
|
117
|
-
|
|
118
|
-
// You should implement PKCE to protect against authorization code interception attacks
|
|
119
|
-
// https://datatracker.ietf.org/doc/html/rfc7636
|
|
120
|
-
// this is left off for simplicity in this example
|
|
121
|
-
|
|
122
|
-
// Generate a unique authorization code
|
|
123
|
-
const authorizationCode = crypto.randomUUID();
|
|
124
|
-
|
|
125
|
-
// Load the database
|
|
126
|
-
const data = await db.read();
|
|
127
|
-
|
|
128
|
-
// Add the user to the database if they aren't there already
|
|
129
|
-
if (!data.users.find((user) => user.id === USERNAME)) {
|
|
130
|
-
data.users.push({
|
|
131
|
-
id: USERNAME,
|
|
132
|
-
authorizationCode: {
|
|
133
|
-
value: authorizationCode,
|
|
134
|
-
expiry: Date.now() + COOKIE_EXPIRY_MS,
|
|
135
|
-
},
|
|
136
|
-
});
|
|
137
|
-
} else {
|
|
138
|
-
// If the user is there, update the authorization code
|
|
139
|
-
// In a production system you would allow at least one authorization code
|
|
140
|
-
// per user per client, but here we simplify and have one per user.
|
|
141
|
-
data.users = data.users.map((user) => {
|
|
142
|
-
if (user.id === USERNAME) {
|
|
143
|
-
return {
|
|
144
|
-
...user,
|
|
145
|
-
authorizationCode: {
|
|
146
|
-
value: authorizationCode,
|
|
147
|
-
expiry: Date.now() + COOKIE_EXPIRY_MS,
|
|
148
|
-
},
|
|
149
|
-
};
|
|
150
|
-
}
|
|
151
|
-
return user;
|
|
152
|
-
});
|
|
153
|
-
}
|
|
154
|
-
if (
|
|
155
|
-
!data.redirect_uris.find((record) => record.redirectUri === redirectUri)
|
|
156
|
-
) {
|
|
157
|
-
data.redirect_uris.push({ redirectUri, authorizationCode });
|
|
158
|
-
} else {
|
|
159
|
-
data.redirect_uris = data.redirect_uris.map((record) => {
|
|
160
|
-
if (record.redirectUri === redirectUri) {
|
|
161
|
-
return { ...record, authorizationCode };
|
|
162
|
-
}
|
|
163
|
-
return record;
|
|
164
|
-
});
|
|
165
|
-
}
|
|
166
|
-
await db.write(data);
|
|
167
|
-
|
|
168
|
-
res.redirect(
|
|
169
|
-
302,
|
|
170
|
-
`${redirectUri}?code=${authorizationCode}&state=${state}`,
|
|
171
|
-
);
|
|
172
|
-
},
|
|
173
|
-
);
|
|
174
|
-
|
|
175
|
-
interface AuthorizationExchangeRequest {
|
|
176
|
-
grant_type: "authorization_code";
|
|
177
|
-
code: string;
|
|
178
|
-
redirect_uri?: string;
|
|
179
|
-
}
|
|
180
|
-
|
|
181
|
-
interface RefreshTokenExchangeRequest {
|
|
182
|
-
grant_type: "refresh_token";
|
|
183
|
-
refresh_token: string;
|
|
184
|
-
}
|
|
185
|
-
|
|
186
|
-
const failureResponse = (res: express.Response, error: string) => {
|
|
187
|
-
return res.status(400).send(`{"error": "${error}"}`);
|
|
188
|
-
};
|
|
189
|
-
|
|
190
|
-
const authorizationCodeExchange = async (
|
|
191
|
-
res: express.Response,
|
|
192
|
-
body: AuthorizationExchangeRequest,
|
|
193
|
-
) => {
|
|
194
|
-
const refresh_token = crypto.randomUUID();
|
|
195
|
-
const access_token = crypto.randomUUID();
|
|
196
|
-
|
|
197
|
-
const code = body.code?.toString();
|
|
198
|
-
|
|
199
|
-
if (!code) {
|
|
200
|
-
return failureResponse(res, "invalid_request");
|
|
201
|
-
}
|
|
202
|
-
|
|
203
|
-
// Load the database
|
|
204
|
-
const data = await db.read();
|
|
205
|
-
const lastRedirectUrl = data.redirect_uris.find(
|
|
206
|
-
(record) => record.authorizationCode === code,
|
|
207
|
-
)?.redirectUri;
|
|
208
|
-
|
|
209
|
-
// The specification requires that if the redirect uri was present in the authorization request,
|
|
210
|
-
// it must be included and the same in the token exchange request
|
|
211
|
-
if (lastRedirectUrl !== body.redirect_uri?.toString()) {
|
|
212
|
-
return failureResponse(res, "invalid_request");
|
|
213
|
-
}
|
|
214
|
-
|
|
215
|
-
// Find the user who was issued this authorization code
|
|
216
|
-
const user = data.users.find(
|
|
217
|
-
(user) => user.authorizationCode?.value === code,
|
|
218
|
-
);
|
|
219
|
-
|
|
220
|
-
if (!user || !user.authorizationCode) {
|
|
221
|
-
return failureResponse(res, "invalid_grant");
|
|
222
|
-
}
|
|
223
|
-
|
|
224
|
-
if (user.authorizationCode.expiry < Date.now()) {
|
|
225
|
-
return failureResponse(res, "invalid_grant");
|
|
226
|
-
}
|
|
227
|
-
|
|
228
|
-
// Update the user with the new access token and refresh token
|
|
229
|
-
// and clear out their authorization code. Authorization codes
|
|
230
|
-
// are single use, so attempting to use the old one will now fail
|
|
231
|
-
data.users = data.users.map((user) => {
|
|
232
|
-
if (user.id === USERNAME) {
|
|
233
|
-
return {
|
|
234
|
-
...user,
|
|
235
|
-
authorizationCode: undefined,
|
|
236
|
-
accessToken: {
|
|
237
|
-
value: access_token,
|
|
238
|
-
expiry: Date.now() + TOKEN_EXPIRY_S * 1000,
|
|
239
|
-
},
|
|
240
|
-
refreshToken: {
|
|
241
|
-
value: refresh_token,
|
|
242
|
-
expiry: Date.now() + REFRESH_EXPIRY_S * 1000,
|
|
243
|
-
},
|
|
244
|
-
};
|
|
245
|
-
}
|
|
246
|
-
return user;
|
|
247
|
-
});
|
|
248
|
-
await db.write(data);
|
|
249
|
-
|
|
250
|
-
return res.status(200).send(
|
|
251
|
-
JSON.stringify({
|
|
252
|
-
access_token,
|
|
253
|
-
refresh_token,
|
|
254
|
-
token_type: "bearer",
|
|
255
|
-
expires_in: TOKEN_EXPIRY_S,
|
|
256
|
-
}),
|
|
257
|
-
);
|
|
258
|
-
};
|
|
259
|
-
|
|
260
|
-
const refreshTokenExchange = async (
|
|
261
|
-
res: express.Response,
|
|
262
|
-
body: RefreshTokenExchangeRequest,
|
|
263
|
-
) => {
|
|
264
|
-
const refresh_token = crypto.randomUUID();
|
|
265
|
-
const access_token = crypto.randomUUID();
|
|
266
|
-
|
|
267
|
-
const old_refresh_token = body.refresh_token?.toString();
|
|
268
|
-
if (!old_refresh_token) {
|
|
269
|
-
return failureResponse(res, "invalid_request");
|
|
270
|
-
}
|
|
271
|
-
|
|
272
|
-
// Find the user who was issued this refresh token
|
|
273
|
-
const data = await db.read();
|
|
274
|
-
const user = data.users.find(
|
|
275
|
-
(user) => user.refreshToken?.value === old_refresh_token,
|
|
276
|
-
);
|
|
277
|
-
|
|
278
|
-
if (!user) {
|
|
279
|
-
return failureResponse(res, "invalid_grant");
|
|
280
|
-
}
|
|
281
|
-
|
|
282
|
-
// Update the user with the new refresh token
|
|
283
|
-
// refresh tokens are single use, so attempting
|
|
284
|
-
// to use the old one will now fail
|
|
285
|
-
data.users = data.users.map((u) => {
|
|
286
|
-
if (u.id === user.id) {
|
|
287
|
-
return {
|
|
288
|
-
...u,
|
|
289
|
-
accessToken: {
|
|
290
|
-
value: access_token,
|
|
291
|
-
expiry: Date.now() + TOKEN_EXPIRY_S * 1000,
|
|
292
|
-
},
|
|
293
|
-
refreshToken: {
|
|
294
|
-
value: refresh_token,
|
|
295
|
-
expiry: Date.now() + REFRESH_EXPIRY_S * 1000,
|
|
296
|
-
},
|
|
297
|
-
};
|
|
298
|
-
}
|
|
299
|
-
return u;
|
|
300
|
-
});
|
|
301
|
-
await db.write(data);
|
|
302
|
-
|
|
303
|
-
return res.status(200).send(
|
|
304
|
-
JSON.stringify({
|
|
305
|
-
access_token,
|
|
306
|
-
refresh_token,
|
|
307
|
-
token_type: "bearer",
|
|
308
|
-
expires_in: TOKEN_EXPIRY_S,
|
|
309
|
-
}),
|
|
310
|
-
);
|
|
311
|
-
};
|
|
312
|
-
|
|
313
|
-
/**
|
|
314
|
-
* This endpoint is the Oauth 2.0 Token endpoint
|
|
315
|
-
* https://datatracker.ietf.org/doc/html/rfc6749#section-3.2
|
|
316
|
-
* It serves both exchanging authorization codes for access tokens (and refresh tokens), and
|
|
317
|
-
* exchanging refresh tokens for new access tokens (and refresh tokens)
|
|
318
|
-
*/
|
|
319
|
-
router.post(
|
|
320
|
-
"/auth/token",
|
|
321
|
-
basicAuth({
|
|
322
|
-
users: { [CLIENT_ID]: CLIENT_SECRET },
|
|
323
|
-
challenge: false,
|
|
324
|
-
}),
|
|
325
|
-
async (req, res) => {
|
|
326
|
-
const body = (await req.body) as
|
|
327
|
-
| AuthorizationExchangeRequest
|
|
328
|
-
| RefreshTokenExchangeRequest;
|
|
329
|
-
|
|
330
|
-
const grantType = body.grant_type?.toString();
|
|
331
|
-
|
|
332
|
-
if (!grantType) {
|
|
333
|
-
return failureResponse(res, "invalid_request");
|
|
334
|
-
}
|
|
335
|
-
|
|
336
|
-
if (grantType !== "authorization_code" && grantType !== "refresh_token") {
|
|
337
|
-
return failureResponse(res, "unsupported_grant_type");
|
|
338
|
-
}
|
|
339
|
-
|
|
340
|
-
if (grantType === "refresh_token") {
|
|
341
|
-
refreshTokenExchange(res, body as RefreshTokenExchangeRequest);
|
|
342
|
-
}
|
|
343
|
-
|
|
344
|
-
return authorizationCodeExchange(
|
|
345
|
-
res,
|
|
346
|
-
body as AuthorizationExchangeRequest,
|
|
347
|
-
);
|
|
348
|
-
},
|
|
349
|
-
);
|
|
350
|
-
|
|
351
|
-
/**
|
|
352
|
-
* TODO: Add this middleware to all routes that will receive requests from
|
|
353
|
-
* your app.
|
|
354
|
-
*/
|
|
355
|
-
const bearerMiddleware = createBearerMiddleware(
|
|
356
|
-
async (access_token: string): Promise<string | undefined> => {
|
|
357
|
-
const data = await db.read();
|
|
358
|
-
const user = data.users.find(
|
|
359
|
-
(user) => user.accessToken?.value === access_token,
|
|
360
|
-
);
|
|
361
|
-
debugLogger(
|
|
362
|
-
`User found: ${user?.id}, expires ${user?.accessToken?.expiry} compare ${Date.now()}`,
|
|
363
|
-
);
|
|
364
|
-
|
|
365
|
-
const isAuthenticated =
|
|
366
|
-
user && user.accessToken && user.accessToken?.expiry > Date.now();
|
|
367
|
-
if (!isAuthenticated) {
|
|
368
|
-
return;
|
|
369
|
-
}
|
|
370
|
-
return user.id;
|
|
371
|
-
},
|
|
372
|
-
);
|
|
373
|
-
|
|
374
|
-
/**
|
|
375
|
-
* All routes that start with /api will be protected by bearer authentication
|
|
376
|
-
*/
|
|
377
|
-
router.use("/api", bearerMiddleware);
|
|
378
|
-
|
|
379
|
-
/**
|
|
380
|
-
* This endpoint checks if a user is authenticated.
|
|
381
|
-
*/
|
|
382
|
-
router.post("/api/authentication/status", async (req, res) => {
|
|
383
|
-
// Check if the user is authenticated
|
|
384
|
-
const isAuthenticated = !!req.user_id;
|
|
385
|
-
|
|
386
|
-
// Return the authentication status
|
|
387
|
-
res.send({
|
|
388
|
-
isAuthenticated,
|
|
389
|
-
});
|
|
390
|
-
});
|
|
391
|
-
|
|
392
|
-
return router;
|
|
393
|
-
};
|
|
@@ -1,44 +0,0 @@
|
|
|
1
|
-
import { Text } from "@canva/app-ui-kit";
|
|
2
|
-
import { useIntl } from "react-intl";
|
|
3
|
-
import { useAppContext } from "src/context";
|
|
4
|
-
|
|
5
|
-
export const LoggedInStatus = (): JSX.Element => {
|
|
6
|
-
const { loggedInState } = useAppContext();
|
|
7
|
-
|
|
8
|
-
const intl = useIntl();
|
|
9
|
-
|
|
10
|
-
const createAuthenticationMessage = () => {
|
|
11
|
-
switch (loggedInState) {
|
|
12
|
-
case "checking":
|
|
13
|
-
return intl.formatMessage({
|
|
14
|
-
defaultMessage: "Checking authentication status...",
|
|
15
|
-
description:
|
|
16
|
-
"A message to indicate that the app is actively checking if the user is logged in",
|
|
17
|
-
});
|
|
18
|
-
case "authenticated":
|
|
19
|
-
//@TODO: Make a call to your own backend to get the user's information.
|
|
20
|
-
return intl.formatMessage(
|
|
21
|
-
{
|
|
22
|
-
defaultMessage: "You are logged in as {name} ({email})",
|
|
23
|
-
description:
|
|
24
|
-
"A message to indicate that the user is logged in and display their name and email address",
|
|
25
|
-
},
|
|
26
|
-
{ name: "Jane Doe", email: "jane@mail.com" },
|
|
27
|
-
);
|
|
28
|
-
case "not_authenticated":
|
|
29
|
-
return "";
|
|
30
|
-
default:
|
|
31
|
-
return intl.formatMessage({
|
|
32
|
-
defaultMessage: "Unknown authentication status",
|
|
33
|
-
description:
|
|
34
|
-
"A message to indicate that it isn't currently known if the user is logged in or not",
|
|
35
|
-
});
|
|
36
|
-
}
|
|
37
|
-
};
|
|
38
|
-
|
|
39
|
-
return (
|
|
40
|
-
<Text alignment="center" size="small">
|
|
41
|
-
{createAuthenticationMessage()}
|
|
42
|
-
</Text>
|
|
43
|
-
);
|
|
44
|
-
};
|
|
@@ -1,26 +0,0 @@
|
|
|
1
|
-
import { useAppContext } from "src/context";
|
|
2
|
-
|
|
3
|
-
export const useAuth = () => {
|
|
4
|
-
const { setLoggedInState, oauth } = useAppContext();
|
|
5
|
-
|
|
6
|
-
const requestAuthentication = async () => {
|
|
7
|
-
try {
|
|
8
|
-
const response = await oauth.requestAuthorization();
|
|
9
|
-
switch (response.status) {
|
|
10
|
-
case "aborted":
|
|
11
|
-
setLoggedInState("not_authenticated");
|
|
12
|
-
break;
|
|
13
|
-
case "completed":
|
|
14
|
-
setLoggedInState("authenticated");
|
|
15
|
-
break;
|
|
16
|
-
default:
|
|
17
|
-
setLoggedInState("not_authenticated");
|
|
18
|
-
}
|
|
19
|
-
} catch (e) {
|
|
20
|
-
// eslint-disable-next-line no-console
|
|
21
|
-
console.error(e);
|
|
22
|
-
}
|
|
23
|
-
};
|
|
24
|
-
|
|
25
|
-
return { requestAuthentication };
|
|
26
|
-
};
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
export * from "./auth";
|