Add invoices app

This commit is contained in:
Lukasz Ostrowski 2023-02-07 20:25:36 +01:00
parent 8f6098aefb
commit 50049cd19e
79 changed files with 38564 additions and 157 deletions

14
.github/workflows/assign-pr.yml vendored Normal file
View file

@ -0,0 +1,14 @@
name: Assign PR to creator
on:
pull_request:
types: [opened]
jobs:
assign_creator:
runs-on: ubuntu-latest
steps:
- name: Assign PR to creator
uses: thomaseizinger/assign-pr-creator-action@v1.0.0
with:
repo-token: ${{ secrets.GITHUB_TOKEN }}

View file

@ -0,0 +1,11 @@
# Set dir where temp PDF will be stored. For Vercel use tmp
# https://vercel.com/guides/how-can-i-use-files-in-serverless-functions
TEMP_PDF_STORAGE_DIR=
#"fatal" | "error" | "warn" | "info" | "debug" | "trace"
APP_DEBUG=info
# Optional
# Regex pattern consumed conditionally to restrcit app installation to specific urls.
# See api/register.tsx
# Leave empty to allow all domains
# Example: "https:\/\/.*.saleor.cloud\/graphql\/" to enable Saleor Cloud APIs
ALLOWED_DOMAIN_PATTERN=

3
apps/invoices/.eslintrc Normal file
View file

@ -0,0 +1,3 @@
{
"extends": ["saleor"]
}

View file

@ -0,0 +1,20 @@
schema: graphql/schema.graphql
documents: [graphql/**/*.graphql, src/**/*.ts, src/**/*.tsx]
extensions:
codegen:
overwrite: true
generates:
generated/graphql.ts:
config:
dedupeFragments: true
plugins:
- typescript
- typescript-operations
- urql-introspection
- typescript-urql:
documentVariablePrefix: "Untyped"
fragmentVariablePrefix: "Untyped"
- typed-document-node
generated/schema.graphql:
plugins:
- schema-ast

114
apps/invoices/README.md Normal file
View file

@ -0,0 +1,114 @@
# Invoice app
## Requirements
- Saleor API 3.10 ❗️
## About Saleor Invoices app
- Generates invoice PDF for each order after invoice is requested (e.g. via dashboard/orders)
- Uploads PDF to Saleor built-in file storage
- Allows to configure shop billing data per each channel
### Learn more about Apps
[Apps guide](https://docs.saleor.io/docs/3.x/developer/extending/apps/key-concepts)
[Configuring apps in dashboard](https://docs.saleor.io/docs/3.x/dashboard/apps)
## Development
### Requirements
Before you start, make sure you have installed:
- [Node.js](https://nodejs.org/en/)
- [pnpm](https://pnpm.io/)
- [Saleor CLI](https://docs.saleor.io/docs/3.x/cli) - optional, but recommended
### With CLI
The easiest way to set up a Saleor app is by using the Saleor CLI.
[Saleor CLI](https://github.com/saleor/saleor-cli) is designed to save you from the repetitive chores around Saleor development, including creating Apps. It will take the burden of spawning new apps locally, connecting them with Saleor environments, and establishing a tunnel for local development in seconds.
[Full Saleor CLI reference](https://docs.saleor.io/docs/3.x/developer/cli)
If you don't have a (free developer) Saleor Cloud account, create one with the following command:
```
saleor register
```
Now you're ready to create your first App:
```
saleor app create [your-app-name]
```
In this step, Saleor CLI will:
- clone this repository to the specified folder
- install dependencies
- ask you whether you'd like to install the app in the selected Saleor environment
- create `.env` file
- start the app in development mode
Having your app ready, the final thing you want to establish is a tunnel with your Saleor environment. Go to your app's directory first and run:
```
saleor app tunnel
```
Your local application should be available now to the outside world (Saleor instance) for accepting all the events via webhooks.
A quick note: the next time you come back to your project, it is enough to launch your app in a standard way (and then launch your tunnel as described earlier):
```
pnpm dev
```
### Without CLI
1. Install the dependencies by running:
```
pnpm install
```
2. Start the local server with:
```
pnpm dev
```
3. Expose local environment using tunnel:
Use tunneling tools like [localtunnel](https://github.com/localtunnel/localtunnel) or [ngrok](https://ngrok.com/).
4. Install aplication at your dashboard:
If you use Saleor Cloud or your local server is exposed, you can install your app by following this link:
```
[YOUR_SALEOR_DASHBOARD_URL]/apps/install?manifestUrl=[YOUR_APP_TUNNEL_MANIFEST_URL]
```
This template host manifest at `/api/manifest`
You can also install application using GQL or command line. Follow the guide [how to install your app](https://docs.saleor.io/docs/3.x/developer/extending/apps/installing-apps#installation-using-graphql-api) to learn more.
### Generated schema and typings
Commands `build` and `dev` would generate schema and typed functions using Saleor's GraphQL endpoint. Commit the `generated` folder to your repo as they are necessary for queries and keeping track of the schema changes.
[Learn more](https://www.graphql-code-generator.com/) about GraphQL code generation.
### Storing registration data - APL
During registration process Saleor API pass the auth token to the app. With this token App can query Saleor API with privileged access (depending on requested permissions during the installation).
To store this data, app-template use a different [APL interfaces](https://github.com/saleor/saleor-app-sdk/blob/main/docs/apl.md).
The choice of the APL is done using `APL` environment variable. If value is not set, FileAPL is used. Available choices:
- `file`: no additional setup is required. Good choice for local development. Can't be used for multi tenant-apps or be deployed (not intended for production)
- `upstash`: use [Upstash](https://upstash.com/) Redis as storage method. Free account required. Can be used for development and production and supports multi-tenancy. Requires `UPSTASH_URL` and `UPSTASH_TOKEN` environment variables to be set
- `vercel`: used by deployments from the Marketplace. It's single-tenant only and only supported by Vercel deployments done with Saleor CLI. Requires `SALEOR_REGISTER_APP_URL` and `SALEOR_DEPLOYMENT_TOKEN` environment variables to be set (handled automatically by the Saleor CLI)
If you want to use your own database, you can implement your own APL. [Check the documentation to read more.](https://github.com/saleor/saleor-app-sdk/blob/main/docs/apl.md)

View file

View file

View file

File diff suppressed because it is too large Load diff

5
apps/invoices/next-env.d.ts vendored Normal file
View file

@ -0,0 +1,5 @@
/// <reference types="next" />
/// <reference types="next/image-types/global" />
// NOTE: This file should not be edited
// see https://nextjs.org/docs/basic-features/typescript for more information.

View file

@ -0,0 +1,46 @@
// This file sets a custom webpack configuration to use your Next.js app
// with Sentry.
// https://nextjs.org/docs/api-reference/next.config.js/introduction
// https://docs.sentry.io/platforms/javascript/guides/nextjs/
const { withSentryConfig } = require("@sentry/nextjs");
const isSentryPropertiesInEnvironment =
process.env.SENTRY_AUTH_TOKEN && process.env.SENTRY_PROJECT && process.env.SENTRY_ORG;
/**
* @type import("@sentry/nextjs").ExportedNextConfig
*/
const moduleExports = {
sentry: {
// Use `hidden-source-map` rather than `source-map` as the Webpack `devtool`
// for client-side builds. (This will be the default starting in
// `@sentry/nextjs` version 8.0.0.) See
// https://webpack.js.org/configuration/devtool/ and
// https://docs.sentry.io/platforms/javascript/guides/nextjs/manual-setup/#use-hidden-source-map
// for more information.
hideSourceMaps: true,
disableServerWebpackPlugin: !isSentryPropertiesInEnvironment,
disableClientWebpackPlugin: !isSentryPropertiesInEnvironment,
},
eslint: {
ignoreDuringBuilds: true,
},
reactStrictMode: true,
};
const sentryWebpackPluginOptions = {
// Additional config options for the Sentry Webpack plugin. Keep in mind that
// the following options are set automatically, and overriding them is not
// recommended:
// release, url, org, project, authToken, configFile, stripPrefix,
// urlPrefix, include, ignore
silent: true, // Suppresses all logs
// For all available options, see:
// https://github.com/getsentry/sentry-webpack-plugin#options.
};
// Make sure adding Sentry options is the last code to run before exporting, to
// ensure that your source maps include changes from all other Webpack plugins
module.exports = withSentryConfig(moduleExports, sentryWebpackPluginOptions);

View file

@ -0,0 +1,78 @@
{
"name": "saleor-app-invoice",
"version": "1.0.0",
"private": true,
"scripts": {
"dev": "pnpm generate && NODE_OPTIONS='--inspect' next dev",
"build": "pnpm generate && next build",
"start": "next start",
"lint": "next lint",
"fetch-schema": "curl https://raw.githubusercontent.com/saleor/saleor/${npm_package_saleor_schemaVersion}/saleor/graphql/schema.graphql > graphql/schema.graphql",
"generate": "graphql-codegen",
"test": "vitest",
"test:ci": "CI=true vitest --coverage"
},
"saleor": {
"schemaVersion": "3.10"
},
"dependencies": {
"@material-ui/core": "^4.12.4",
"@material-ui/icons": "^4.11.3",
"@material-ui/lab": "4.0.0-alpha.61",
"@saleor/app-sdk": "0.27.1",
"@saleor/macaw-ui": "^0.7.2",
"@sentry/nextjs": "^7.31.1",
"@tanstack/react-query": "^4.19.1",
"@trpc/client": "^10.9.0",
"@trpc/next": "^10.9.0",
"@trpc/react-query": "^10.9.0",
"@trpc/server": "^10.9.0",
"@urql/exchange-auth": "^1.0.0",
"@urql/exchange-multipart-fetch": "^1.0.1",
"@web-std/file": "^3.0.2",
"clsx": "^1.2.1",
"graphql": "^16.6.0",
"graphql-tag": "^2.12.6",
"microinvoice": "^1.0.6",
"next": "13.0.6",
"pino": "^8.8.0",
"pino-pretty": "^9.1.1",
"puppeteer": "^19.4.0",
"react": "18.2.0",
"react-dom": "18.2.0",
"react-hook-form": "^7.41.0",
"tiny-invariant": "^1.3.1",
"urql": "^3.0.3",
"usehooks-ts": "^2.9.1",
"zod": "^3.19.1"
},
"devDependencies": {
"@graphql-codegen/cli": "2.13.3",
"@graphql-codegen/introspection": "2.2.1",
"@graphql-codegen/typed-document-node": "^2.3.3",
"@graphql-codegen/typescript": "2.7.3",
"@graphql-codegen/typescript-operations": "2.5.3",
"@graphql-codegen/typescript-urql": "^3.7.0",
"@graphql-codegen/urql-introspection": "2.2.1",
"@graphql-typed-document-node/core": "^3.1.1",
"@types/node": "^18.8.1",
"@types/react": "^18.0.21",
"@types/react-dom": "^18.0.6",
"@types/rimraf": "^3.0.2",
"@vitejs/plugin-react": "^3.0.0",
"@vitest/coverage-c8": "^0.25.7",
"eslint": "8.25.0",
"eslint-config-next": "13.0.6",
"eslint-config-prettier": "^8.5.0",
"jsdom": "^20.0.3",
"prettier": "^2.7.1",
"rimraf": "^3.0.2",
"typescript": "4.9.4",
"vite": "^4.0.0",
"vitest": "^0.25.7"
},
"lint-staged": {
"*.{js,ts,tsx}": "eslint --cache --fix",
"*.{js,ts,tsx,css,md,json}": "prettier --write"
}
}

7623
apps/invoices/pnpm-lock.yaml Normal file

File diff suppressed because it is too large Load diff

View file

@ -0,0 +1,39 @@
import { APL, FileAPL, SaleorCloudAPL, UpstashAPL, VercelAPL } from "@saleor/app-sdk/APL";
import { SaleorApp } from "@saleor/app-sdk/saleor-app";
const aplType = process.env.APL ?? "file";
let apl: APL;
switch (aplType) {
case "vercel":
apl = new VercelAPL();
break;
case "upstash":
apl = new UpstashAPL();
break;
case "file":
apl = new FileAPL();
break;
case "rest": {
if (!process.env.REST_APL_ENDPOINT || !process.env.REST_APL_TOKEN) {
throw new Error("Rest APL is not configured - missing env variables. Check saleor-app.ts");
}
apl = new SaleorCloudAPL({
resourceUrl: process.env.REST_APL_ENDPOINT,
token: process.env.REST_APL_TOKEN,
});
break;
}
default: {
throw new Error("Invalid APL config, ");
}
}
export const saleorApp = new SaleorApp({
apl,
});

View file

@ -0,0 +1,17 @@
// This file configures the initialization of Sentry on the browser.
// The config you add here will be used whenever a page is visited.
// https://docs.sentry.io/platforms/javascript/guides/nextjs/
import * as Sentry from "@sentry/nextjs";
const SENTRY_DSN = process.env.SENTRY_DSN || process.env.NEXT_PUBLIC_SENTRY_DSN;
Sentry.init({
dsn: SENTRY_DSN,
// Adjust this value in production, or use tracesSampler for greater control
tracesSampleRate: 1.0,
// ...
// Note: if you want to override the automatic release value, do not set a
// `release` value here - use the environment variable `SENTRY_RELEASE`, so
// that it will also get attached to your source maps
});

View file

@ -0,0 +1,17 @@
// This file configures the initialization of Sentry on the server.
// The config you add here will be used whenever middleware or an Edge route handles a request.
// https://docs.sentry.io/platforms/javascript/guides/nextjs/
import * as Sentry from "@sentry/nextjs";
const SENTRY_DSN = process.env.SENTRY_DSN || process.env.NEXT_PUBLIC_SENTRY_DSN;
Sentry.init({
dsn: SENTRY_DSN,
// Adjust this value in production, or use tracesSampler for greater control
tracesSampleRate: 1.0,
// ...
// Note: if you want to override the automatic release value, do not set a
// `release` value here - use the environment variable `SENTRY_RELEASE`, so
// that it will also get attached to your source maps
});

View file

@ -0,0 +1,17 @@
// This file configures the initialization of Sentry on the server.
// The config you add here will be used whenever the server handles a request.
// https://docs.sentry.io/platforms/javascript/guides/nextjs/
import * as Sentry from "@sentry/nextjs";
const SENTRY_DSN = process.env.SENTRY_DSN || process.env.NEXT_PUBLIC_SENTRY_DSN;
Sentry.init({
dsn: SENTRY_DSN,
// Adjust this value in production, or use tracesSampler for greater control
tracesSampleRate: 1.0,
// ...
// Note: if you want to override the automatic release value, do not set a
// `release` value here - use the environment variable `SENTRY_RELEASE`, so
// that it will also get attached to your source maps
});

View file

@ -0,0 +1,13 @@
<svg width="19" height="19" viewBox="0 0 19 19" fill="none" xmlns="http://www.w3.org/2000/svg">
<path d="M16 0.375C16.8975 0.375 17.625 1.10254 17.625 2L17.625 3.89063C17.625 4.2358 17.3452 4.51563 17 4.51562C16.6548 4.51562 16.375 4.2358 16.375 3.89062L16.375 2C16.375 1.79289 16.2071 1.625 16 1.625H2C1.79289 1.625 1.625 1.79289 1.625 2V13C1.625 13.2071 1.79289 13.375 2 13.375H5C5.34518 13.375 5.625 13.6548 5.625 14C5.625 14.3452 5.34518 14.625 5 14.625H2C1.10254 14.625 0.375 13.8975 0.375 13V2C0.375 1.10254 1.10254 0.375 2 0.375H16Z"
fill="#fff"/>
<path d="M4 5C4.55228 5 5 4.55228 5 4C5 3.44772 4.55228 3 4 3C3.44771 3 3 3.44772 3 4C3 4.55228 3.44771 5 4 5Z"
fill="#fff"/>
<path d="M8 4C8 4.55228 7.55228 5 7 5C6.44771 5 6 4.55228 6 4C6 3.44772 6.44771 3 7 3C7.55228 3 8 3.44772 8 4Z"
fill="#fff"/>
<path d="M13.625 10.375V10C13.625 9.65482 13.3452 9.375 13 9.375C12.6548 9.375 12.375 9.65482 12.375 10V10.3797C11.5359 10.4436 10.875 11.1446 10.875 12C10.875 12.8975 11.6025 13.625 12.5 13.625H13.5C13.7071 13.625 13.875 13.7929 13.875 14C13.875 14.2071 13.7071 14.375 13.5 14.375H11.5C11.1548 14.375 10.875 14.6548 10.875 15C10.875 15.3452 11.1548 15.625 11.5 15.625H12.375V16C12.375 16.3452 12.6548 16.625 13 16.625C13.3452 16.625 13.625 16.3452 13.625 16V15.6203C14.4641 15.5564 15.125 14.8554 15.125 14C15.125 13.1025 14.3975 12.375 13.5 12.375H12.5C12.2929 12.375 12.125 12.2071 12.125 12C12.125 11.7929 12.2929 11.625 12.5 11.625H14.5C14.8452 11.625 15.125 11.3452 15.125 11C15.125 10.6548 14.8452 10.375 14.5 10.375H13.625Z"
fill="#fff"/>
<path fill-rule="evenodd" clip-rule="evenodd"
d="M18.625 8.96838V17C18.625 17.8975 17.8975 18.625 17 18.625H9C8.10254 18.625 7.375 17.8975 7.375 17V7C7.375 6.10254 8.10254 5.375 9 5.375H14.6379C15.0181 5.375 15.3862 5.50828 15.6782 5.75164L18.0403 7.72002C18.4108 8.02876 18.625 8.48611 18.625 8.96838ZM8.625 7C8.625 6.79289 8.79289 6.625 9 6.625H13.875V8C13.875 8.89746 14.6025 9.625 15.5 9.625H17.375V17C17.375 17.2071 17.2071 17.375 17 17.375H9C8.79289 17.375 8.625 17.2071 8.625 17V7ZM16.8737 8.375H15.5C15.2929 8.375 15.125 8.20711 15.125 8V6.91773L16.8737 8.375Z"
fill="#fff"/>
</svg>

After

Width:  |  Height:  |  Size: 2.2 KiB

View file

@ -0,0 +1,16 @@
import { SellerShopConfig } from "../modules/app-configuration/app-config";
export const getMockAddress = (): SellerShopConfig["address"] => {
return {
city: "Wrocław",
cityArea: "",
companyName: "Saleor",
country: "Poland",
countryArea: "Dolnoslaskie",
firstName: "",
lastName: "",
postalCode: "12-123",
streetAddress1: "Techowa 7",
streetAddress2: "",
};
};

View file

@ -0,0 +1,102 @@
import { OrderPayloadFragment, OrderStatus } from "../../generated/graphql";
export const mockOrder: OrderPayloadFragment = {
channel: {
slug: "default-channel",
},
shippingPrice: {
currency: "USD",
gross: {
amount: 1,
currency: "USD",
},
net: {
amount: 1,
currency: "USD",
},
tax: {
amount: 0,
currency: "USD",
},
},
shippingMethodName: "CyCreateVariants-1462",
number: "3991",
id: "T3JkZXI6OTFiZjM5ZDQtZjRiMC00M2QyLTgwMjEtZjVkMTMwNDVlMjkx",
billingAddress: {
id: "QWRkcmVzczoxNzE4Ng==",
country: {
country: "Poland",
code: "PL",
},
companyName: "Fajna firma lol",
cityArea: "",
countryArea: "",
streetAddress1: "street 1",
streetAddress2: "Street 2",
postalCode: "55-123",
phone: "+48690563008",
firstName: "MAdzia",
lastName: "Markusik",
city: "WRO",
},
created: "2022-12-02T15:05:56.637068+00:00",
fulfillments: [],
status: OrderStatus.Unfulfilled,
total: {
currency: "USD",
gross: {
amount: 207.15,
currency: "USD",
},
net: {
amount: 206,
currency: "USD",
},
tax: {
amount: 1.15,
currency: "USD",
},
},
lines: [
{
productName: "Tales of pirate kittycat",
variantName: "Signed: Yes / vinyl",
quantity: 2,
totalPrice: {
currency: "USD",
gross: {
amount: 200,
currency: "USD",
},
net: {
amount: 200,
currency: "USD",
},
tax: {
amount: 0,
currency: "USD",
},
},
},
{
productName: "White Hoodie",
variantName: "10404946",
quantity: 1,
totalPrice: {
currency: "USD",
gross: {
amount: 6.15,
currency: "USD",
},
net: {
amount: 5,
currency: "USD",
},
tax: {
amount: 1.15,
currency: "USD",
},
},
},
],
};

View file

@ -0,0 +1,45 @@
import { AuthConfig, authExchange } from "@urql/exchange-auth";
import { cacheExchange, createClient as urqlCreateClient, dedupExchange } from "urql";
import { multipartFetchExchange } from "@urql/exchange-multipart-fetch";
interface IAuthState {
token: string;
}
export const createClient = (url: string, getAuth: AuthConfig<IAuthState>["getAuth"]) =>
urqlCreateClient({
url,
exchanges: [
dedupExchange,
cacheExchange,
authExchange<IAuthState>({
addAuthToOperation: ({ authState, operation }) => {
if (!authState || !authState?.token) {
return operation;
}
const fetchOptions =
typeof operation.context.fetchOptions === "function"
? operation.context.fetchOptions()
: operation.context.fetchOptions || {};
return {
...operation,
context: {
...operation.context,
fetchOptions: {
...fetchOptions,
headers: {
...fetchOptions.headers,
"Authorization-Bearer": authState.token,
},
},
},
};
},
getAuth,
}),
multipartFetchExchange,
],
});

View file

@ -0,0 +1,7 @@
export function isInIframe() {
try {
return window.self !== window.top;
} catch (e) {
return true;
}
}

View file

@ -0,0 +1,19 @@
import pino from "pino";
/**
* TODO Set up log drain etc
*/
export const logger = pino({
level: process.env.APP_DEBUG ?? "silent",
transport:
process.env.NODE_ENV === "development"
? {
target: "pino-pretty",
options: {
colorize: true,
},
}
: undefined,
});
export const createLogger = logger.child.bind(logger);

View file

@ -0,0 +1,8 @@
import React, { PropsWithChildren } from "react";
import dynamic from "next/dynamic";
const Wrapper = (props: PropsWithChildren<{}>) => <React.Fragment>{props.children}</React.Fragment>;
export const NoSSRWrapper = dynamic(() => Promise.resolve(Wrapper), {
ssr: false,
});

View file

@ -0,0 +1,33 @@
import { useAppBridge } from "@saleor/app-sdk/app-bridge";
import { useTheme } from "@saleor/macaw-ui";
import { memo, useEffect } from "react";
/**
* Macaw-ui stores its theme mode in memory and local storage. To synchronize App with Dashboard,
* Macaw must be informed about this change from AppBridge.
*
* If you are not using Macaw, you can remove this.
*/
function _ThemeSynchronizer() {
const { appBridgeState } = useAppBridge();
const { setTheme, themeType } = useTheme();
useEffect(() => {
if (!setTheme || !appBridgeState?.theme) {
return;
}
if (themeType !== appBridgeState?.theme) {
setTheme(appBridgeState.theme);
/**
* Hack to fix macaw, which is going into infinite loop on light mode (probably de-sync local storage with react state)
* TODO Fix me when Macaw 2.0 is shipped
*/
window.localStorage.setItem("macaw-ui-theme", appBridgeState.theme);
}
}, [appBridgeState?.theme, setTheme, themeType]);
return null;
}
export const ThemeSynchronizer = memo(_ThemeSynchronizer);

View file

@ -0,0 +1,18 @@
import { SellerShopConfig } from "./app-config";
export const Address = {
createEmpty(): SellerShopConfig["address"] {
return {
city: "",
cityArea: "",
companyName: "",
country: "",
countryArea: "",
firstName: "",
lastName: "",
postalCode: "",
streetAddress1: "",
streetAddress2: "",
};
},
};

View file

@ -0,0 +1,74 @@
import { describe, it, expect } from "vitest";
import { AppConfigContainer } from "./app-config-container";
import { AppConfig, SellerShopConfig } from "./app-config";
const getDefaultAddressData = (): SellerShopConfig["address"] => ({
city: "",
cityArea: "",
companyName: "Saleor",
country: "",
countryArea: "",
firstName: "",
lastName: "",
postalCode: "",
streetAddress1: "",
streetAddress2: "",
});
describe("AppConfigContainer", () => {
describe("Get address from config", () => {
it("Gets address if exists", () => {
expect(
AppConfigContainer.getChannelAddress({
shopConfigPerChannel: {
channel: {
address: getDefaultAddressData(),
},
},
})("channel")
).toEqual(
expect.objectContaining({
companyName: "Saleor",
})
);
});
it("Returns null if entire config is null", () => {
expect(AppConfigContainer.getChannelAddress(null)("channel")).toEqual(null);
});
});
describe("Set address to config per slug of the channel", () => {
it("Will create entire config object if initially was null", () => {
const newConfig = AppConfigContainer.setChannelAddress(null)("channel")(
getDefaultAddressData()
);
expect(newConfig).toEqual({
shopConfigPerChannel: expect.objectContaining({
channel: expect.objectContaining({
address: expect.objectContaining({ companyName: "Saleor" }),
}),
}),
});
});
it("Will preserve another existing config for another channel after setting a new one", () => {
const config: AppConfig = {
shopConfigPerChannel: {
c1: {
address: {
...getDefaultAddressData(),
companyName: "Mirumee",
},
},
},
};
const newConfig = AppConfigContainer.setChannelAddress(config)("c2")(getDefaultAddressData());
expect(newConfig.shopConfigPerChannel.c1.address.companyName).toEqual("Mirumee");
expect(newConfig.shopConfigPerChannel.c2.address.companyName).toEqual("Saleor");
});
});
});

View file

@ -0,0 +1,39 @@
import { AppConfig, SellerShopConfig } from "./app-config";
const getDefaultEmptyAddress = (): SellerShopConfig["address"] => ({
city: "",
cityArea: "",
companyName: "",
country: "",
countryArea: "",
firstName: "",
lastName: "",
postalCode: "",
streetAddress1: "",
streetAddress2: "",
});
const getChannelAddress = (appConfig: AppConfig | null | undefined) => (channelSlug: string) => {
try {
return appConfig?.shopConfigPerChannel[channelSlug].address ?? null;
} catch (e) {
return null;
}
};
const setChannelAddress =
(appConfig: AppConfig | null | undefined) =>
(channelSlug: string) =>
(address: SellerShopConfig["address"]) => {
const appConfigNormalized = structuredClone(appConfig) ?? { shopConfigPerChannel: {} };
appConfigNormalized.shopConfigPerChannel[channelSlug] ??= { address: getDefaultEmptyAddress() };
appConfigNormalized.shopConfigPerChannel[channelSlug].address = address;
return appConfigNormalized;
};
export const AppConfigContainer = {
getChannelAddress,
setChannelAddress,
};

View file

@ -0,0 +1,49 @@
import {describe, it, expect} from "vitest";
import {appConfigInputSchema} from "./app-config-input-schema";
import {AppConfig, SellerShopConfig} from "./app-config";
import {getMockAddress} from "../../fixtures/mock-address";
describe("appConfigInputSchema", () => {
it('Passes with no channels at all', () => {
expect(() =>
appConfigInputSchema.parse({
shopConfigPerChannel: {}
} satisfies AppConfig)
).not.to.throw()
})
it('Passes with all address fields empty', () => {
expect(() =>
appConfigInputSchema.parse({
shopConfigPerChannel: {
channel: {
address: {
city: "",
cityArea: "",
companyName: "",
country: "",
countryArea: "",
firstName: "",
lastName: "",
postalCode: "",
streetAddress1: "",
streetAddress2: ""
}
}
}
} satisfies AppConfig)
).not.to.throw()
})
it('Passes with partial address', () => {
expect(() =>
appConfigInputSchema.parse({
shopConfigPerChannel: {
channel: {
address: getMockAddress() }
}
} satisfies AppConfig)
).not.to.throw()
})
})

View file

@ -0,0 +1,23 @@
import { z } from "zod";
export const appConfigInputSchema = z.object({
shopConfigPerChannel: z.record(
z.object({
address: z.object({
/**
* min() to allow empty strings
*/
companyName: z.string().min(0),
cityArea: z.string().min(0),
countryArea: z.string().min(0),
streetAddress1: z.string().min(0),
streetAddress2: z.string().min(0),
postalCode: z.string().min(0),
firstName: z.string().min(0),
lastName: z.string().min(0),
city: z.string().min(0),
country: z.string().min(0),
}),
})
),
});

View file

@ -0,0 +1,22 @@
import { AddressFragment } from "../../../generated/graphql";
export interface SellerShopConfig {
address: {
companyName: string;
cityArea: string;
countryArea: string;
streetAddress1: string;
streetAddress2: string;
postalCode: string;
firstName: string;
lastName: string;
city: string;
country: string;
};
}
export type ShopConfigPerChannelSlug = Record<string, SellerShopConfig>;
export type AppConfig = {
shopConfigPerChannel: ShopConfigPerChannelSlug;
};

View file

@ -0,0 +1,37 @@
import { router } from "../trpc/trpc-server";
import { protectedClientProcedure } from "../trpc/protected-client-procedure";
import { PrivateMetadataAppConfigurator } from "./app-configurator";
import { createSettingsManager } from "./metadata-manager";
import { logger as pinoLogger } from "../../lib/logger";
import { appConfigInputSchema } from "./app-config-input-schema";
import { GetAppConfigurationService } from "./get-app-configuration.service";
export const appConfigurationRouter = router({
fetch: protectedClientProcedure.query(async ({ ctx, input }) => {
const logger = pinoLogger.child({ saleorApiUrl: ctx.saleorApiUrl });
logger.debug("appConfigurationRouter.fetch called");
return new GetAppConfigurationService({
apiClient: ctx.apiClient,
saleorApiUrl: ctx.saleorApiUrl,
}).getConfiguration();
}),
setAndReplace: protectedClientProcedure
.meta({ requiredClientPermissions: ["MANAGE_APPS"] })
.input(appConfigInputSchema)
.mutation(async ({ ctx, input }) => {
const logger = pinoLogger.child({ saleorApiUrl: ctx.saleorApiUrl });
logger.debug(input, "appConfigurationRouter.setAndReplace called with input");
const appConfigurator = new PrivateMetadataAppConfigurator(
createSettingsManager(ctx.apiClient),
ctx.saleorApiUrl
);
await appConfigurator.setConfig(input);
return null;
}),
});

View file

@ -0,0 +1,35 @@
import { AppConfig } from "./app-config";
import { SettingsManager } from "@saleor/app-sdk/settings-manager";
export interface AppConfigurator {
setConfig(config: AppConfig): Promise<void>;
getConfig(): Promise<AppConfig | undefined>;
}
export class PrivateMetadataAppConfigurator implements AppConfigurator {
private metadataKey = "app-config";
constructor(private metadataManager: SettingsManager, private saleorApiUrl: string) {}
getConfig(): Promise<AppConfig | undefined> {
return this.metadataManager.get(this.metadataKey, this.saleorApiUrl).then((data) => {
if (!data) {
return data;
}
try {
return JSON.parse(data);
} catch (e) {
throw new Error("Invalid metadata value, cant be parsed");
}
});
}
setConfig(config: AppConfig): Promise<void> {
return this.metadataManager.set({
key: this.metadataKey,
value: JSON.stringify(config),
domain: this.saleorApiUrl,
});
}
}

View file

@ -0,0 +1,31 @@
import { AppConfig } from "./app-config";
import { AppConfigContainer } from "./app-config-container";
import { ChannelFragment, ShopInfoFragment } from "../../../generated/graphql";
/**
* TODO Test
*/
export const FallbackAppConfig = {
createFallbackConfigFromExistingShopAndChannels(
channels: ChannelFragment[],
shopAddress: ShopInfoFragment | null
) {
return (channels ?? []).reduce<AppConfig>(
(state, channel) => {
return AppConfigContainer.setChannelAddress(state)(channel.slug)({
city: shopAddress?.companyAddress?.city ?? "",
cityArea: shopAddress?.companyAddress?.cityArea ?? "",
companyName: shopAddress?.companyAddress?.companyName ?? "",
country: shopAddress?.companyAddress?.country.country ?? "",
countryArea: shopAddress?.companyAddress?.countryArea ?? "",
firstName: shopAddress?.companyAddress?.firstName ?? "",
lastName: shopAddress?.companyAddress?.lastName ?? "",
postalCode: shopAddress?.companyAddress?.postalCode ?? "",
streetAddress1: shopAddress?.companyAddress?.streetAddress1 ?? "",
streetAddress2: shopAddress?.companyAddress?.streetAddress2 ?? "",
});
},
{ shopConfigPerChannel: {} }
);
},
};

View file

@ -0,0 +1,65 @@
import { PrivateMetadataAppConfigurator } from "./app-configurator";
import { createSettingsManager } from "./metadata-manager";
import { ChannelsFetcher } from "../channels/channels-fetcher";
import { ShopInfoFetcher } from "../shop-info/shop-info-fetcher";
import { FallbackAppConfig } from "./fallback-app-config";
import { Client } from "urql";
import { logger as pinoLogger } from "../../lib/logger";
// todo test
export class GetAppConfigurationService {
constructor(
private settings: {
apiClient: Client;
saleorApiUrl: string;
}
) {}
async getConfiguration() {
const logger = pinoLogger.child({
service: "GetAppConfigurationService",
saleorApiUrl: this.settings.saleorApiUrl,
});
const { saleorApiUrl, apiClient } = this.settings;
const appConfigurator = new PrivateMetadataAppConfigurator(
createSettingsManager(apiClient),
saleorApiUrl
);
const savedAppConfig = (await appConfigurator.getConfig()) ?? null;
logger.debug(savedAppConfig, "Retrieved app config from Metadata. Will return it");
if (savedAppConfig) {
return savedAppConfig;
}
logger.info("App config not found in metadata. Will create default config now.");
const channelsFetcher = new ChannelsFetcher(apiClient);
const shopInfoFetcher = new ShopInfoFetcher(apiClient);
const [channels, shopAddress] = await Promise.all([
channelsFetcher.fetchChannels(),
shopInfoFetcher.fetchShopInfo(),
]);
logger.debug(channels, "Fetched channels");
logger.debug(shopAddress, "Fetched shop address");
const appConfig = FallbackAppConfig.createFallbackConfigFromExistingShopAndChannels(
channels ?? [],
shopAddress
);
logger.debug(appConfig, "Created a fallback AppConfig. Will save it.");
await appConfigurator.setConfig(appConfig);
logger.info("Saved initial AppConfig");
return appConfig;
}
}

View file

@ -0,0 +1,93 @@
import { MetadataEntry, EncryptedMetadataManager } from "@saleor/app-sdk/settings-manager";
import { Client, gql } from "urql";
import {
FetchAppDetailsDocument,
FetchAppDetailsQuery,
UpdateAppMetadataDocument,
} from "../../../generated/graphql";
gql`
mutation UpdateAppMetadata($id: ID!, $input: [MetadataInput!]!) {
updatePrivateMetadata(id: $id, input: $input) {
item {
privateMetadata {
key
value
}
}
}
}
`;
gql`
query FetchAppDetails {
app {
id
privateMetadata {
key
value
}
}
}
`;
export async function fetchAllMetadata(client: Client): Promise<MetadataEntry[]> {
const { error, data } = await client
.query<FetchAppDetailsQuery>(FetchAppDetailsDocument, {})
.toPromise();
if (error) {
return [];
}
return data?.app?.privateMetadata.map((md) => ({ key: md.key, value: md.value })) || [];
}
export async function mutateMetadata(client: Client, metadata: MetadataEntry[]) {
// to update the metadata, ID is required
const { error: idQueryError, data: idQueryData } = await client
.query(FetchAppDetailsDocument, {})
.toPromise();
if (idQueryError) {
throw new Error(
"Could not fetch the app id. Please check if auth data for the client are valid."
);
}
const appId = idQueryData?.app?.id;
if (!appId) {
throw new Error("Could not fetch the app ID");
}
const { error: mutationError, data: mutationData } = await client
.mutation(UpdateAppMetadataDocument, {
id: appId,
input: metadata,
})
.toPromise();
if (mutationError) {
throw new Error(`Mutation error: ${mutationError.message}`);
}
return (
mutationData?.updatePrivateMetadata?.item?.privateMetadata.map((md) => ({
key: md.key,
value: md.value,
})) || []
);
}
export const createSettingsManager = (client: Client) => {
// EncryptedMetadataManager gives you interface to manipulate metadata and cache values in memory.
// We recommend it for production, because all values are encrypted.
// If your use case require plain text values, you can use MetadataManager.
return new EncryptedMetadataManager({
// Secret key should be randomly created for production and set as environment variable
encryptionKey: process.env.SECRET_KEY!,
fetchMetadata: () => fetchAllMetadata(client),
mutateMetadata: (metadata) => mutateMetadata(client, metadata),
});
};

View file

@ -0,0 +1,80 @@
import { SellerShopConfig } from "../app-config";
import { useForm } from "react-hook-form";
import { TextField, TextFieldProps, Typography } from "@material-ui/core";
import { Button, makeStyles } from "@saleor/macaw-ui";
import React from "react";
import { actions, useAppBridge } from "@saleor/app-sdk/app-bridge";
const useStyles = makeStyles({
field: {
marginBottom: 20,
},
form: {
padding: 20,
},
channelName: {
fontFamily: "monospace",
cursor: "pointer",
},
});
type Props = {
channelSlug: string;
channelName: string;
channelID: string;
onSubmit(data: SellerShopConfig["address"]): Promise<void>;
initialData?: SellerShopConfig["address"] | null;
};
export const AddressForm = (props: Props) => {
const { register, handleSubmit } = useForm<SellerShopConfig["address"]>({
defaultValues: props.initialData ?? undefined,
});
const styles = useStyles();
const { appBridge } = useAppBridge();
const CommonFieldProps: TextFieldProps = {
className: styles.field,
fullWidth: true,
};
const handleChannelNameClick = () => {
appBridge?.dispatch(
actions.Redirect({
to: `/channels/${props.channelID}`,
})
);
};
return (
<form
onSubmit={handleSubmit((data, event) => {
props.onSubmit(data);
})}
className={styles.form}
>
<Typography variant="body1" paragraph>
Configure
<strong onClick={handleChannelNameClick} className={styles.channelName}>
{` ${props.channelName} `}
</strong>
channel:
</Typography>
<TextField label="Company Name" {...CommonFieldProps} {...register("companyName")} />
<TextField {...CommonFieldProps} label="First Name" {...register("firstName")} />
<TextField {...CommonFieldProps} label="Last Name" {...register("lastName")} />
<TextField label="Street Address 1" {...CommonFieldProps} {...register("streetAddress1")} />
<TextField {...CommonFieldProps} label="Street Address 2" {...register("streetAddress2")} />
<div style={{ display: "grid", gap: 20, gridTemplateColumns: "1fr 2fr" }}>
<TextField {...CommonFieldProps} label="Postal Code" {...register("postalCode")} />
<TextField {...CommonFieldProps} label="City" {...register("city")} />
</div>
<TextField {...CommonFieldProps} label="City Area" {...register("cityArea")} />
<TextField {...CommonFieldProps} label="Country" {...register("country")} />
<TextField label="Country Area" {...CommonFieldProps} {...register("countryArea")} />
<Button type="submit" fullWidth variant="primary">
Save channel configuration
</Button>
</form>
);
};

View file

@ -0,0 +1,138 @@
import { trpcClient } from "../../trpc/trpc-client";
import { LinearProgress, Link, Paper, Typography } from "@material-ui/core";
import React, { useEffect, useMemo, useState } from "react";
import { makeStyles } from "@saleor/macaw-ui";
import { AppConfigContainer } from "../app-config-container";
import { AddressForm } from "./address-form";
import { ChannelsList } from "./channels-list";
import { actions, useAppBridge } from "@saleor/app-sdk/app-bridge";
import { AppColumnsLayout } from "../../ui/app-columns-layout";
const useStyles = makeStyles((theme) => {
return {
header: { marginBottom: 20 },
grid: { display: "grid", gridTemplateColumns: "1fr 1fr", alignItems: "start", gap: 40 },
formContainer: {
top: 0,
position: "sticky",
},
instructionsContainer: {
padding: 15,
},
};
});
export const ChannelsConfiguration = () => {
const styles = useStyles();
const { appBridge } = useAppBridge();
const { data: configurationData, refetch: refetchConfig } =
trpcClient.appConfiguration.fetch.useQuery();
const channels = trpcClient.channels.fetch.useQuery();
const [activeChannelSlug, setActiveChannelSlug] = useState<string | null>(null);
const { mutate, error: saveError } = trpcClient.appConfiguration.setAndReplace.useMutation({
onSuccess() {
refetchConfig();
appBridge?.dispatch(
actions.Notification({
title: "Success",
text: "Saved app configuration",
status: "success",
})
);
},
});
useEffect(() => {
if (channels.isSuccess) {
setActiveChannelSlug(channels.data![0].slug ?? null);
}
}, [channels.isSuccess, channels.data]);
const activeChannel = useMemo(() => {
try {
return channels.data!.find((c) => c.slug === activeChannelSlug)!;
} catch (e) {
return null;
}
}, [channels.data, activeChannelSlug]);
if (channels.isLoading || !channels.data) {
return <LinearProgress />;
}
if (!activeChannel) {
return <div>Error. No channel available</div>;
}
return (
<AppColumnsLayout>
<ChannelsList
channels={channels.data}
activeChannelSlug={activeChannel.slug}
onChannelClick={setActiveChannelSlug}
/>
{activeChannel ? (
<Paper elevation={0} className={styles.formContainer}>
<AddressForm
channelID={activeChannel.id}
key={activeChannelSlug}
channelSlug={activeChannel.slug}
onSubmit={async (data) => {
const newConfig = AppConfigContainer.setChannelAddress(configurationData)(
activeChannel.slug
)(data);
mutate(newConfig);
}}
initialData={AppConfigContainer.getChannelAddress(configurationData)(
activeChannel.slug
)}
channelName={activeChannel?.name ?? activeChannelSlug}
/>
{saveError && <span>{saveError.message}</span>}
</Paper>
) : null}
<Paper elevation={0} className={styles.instructionsContainer}>
<Typography paragraph variant="h4">
Generate invoices for orders in your shop
</Typography>
<Typography paragraph>
Shop data on the invoice an be configured per channel. If not set it will use shop data
from{" "}
<Link
onClick={() => {
appBridge?.dispatch(
actions.Redirect({
to: "/site-settings",
})
);
}}
>
the configuration
</Link>
</Typography>
<Typography>
Go to{" "}
<Link
onClick={() => {
appBridge?.dispatch(
actions.Redirect({
to: "/orders",
})
);
}}
>
Orders
</Link>{" "}
and open any Order. Then click <strong>Invoices -{">"} Generate</strong>. Invoice will be
added to the order page
</Typography>
</Paper>
</AppColumnsLayout>
);
};

View file

@ -0,0 +1,65 @@
import {
makeStyles,
OffsettedList,
OffsettedListBody,
OffsettedListHeader,
OffsettedListItem,
OffsettedListItemCell,
} from "@saleor/macaw-ui";
import clsx from "clsx";
import { Typography } from "@material-ui/core";
import React from "react";
import { ChannelFragment } from "../../../../generated/graphql";
const useStyles = makeStyles((theme) => {
return {
listItem: {
cursor: "pointer",
height: "auto !important",
},
listItemActive: {
border: `2px solid ${theme.palette.primary.main}`,
},
cellSlug: {
fontFamily: "monospace",
opacity: 0.8,
},
};
});
type Props = {
channels: ChannelFragment[];
activeChannelSlug: string;
onChannelClick(channelSlug: string): void;
};
export const ChannelsList = ({ channels, activeChannelSlug, onChannelClick }: Props) => {
const styles = useStyles();
return (
<OffsettedList gridTemplate={["1fr"]}>
<OffsettedListBody>
{channels.map((c) => {
return (
<OffsettedListItem
className={clsx(styles.listItem, {
[styles.listItemActive]: c.slug === activeChannelSlug,
})}
key={c.slug}
onClick={() => {
onChannelClick(c.slug);
}}
>
<OffsettedListItemCell>
{c.name}
<Typography variant="caption">
<code>{c.slug}</code>
</Typography>
</OffsettedListItemCell>
</OffsettedListItem>
);
})}
</OffsettedListBody>
</OffsettedList>
);
};

View file

@ -0,0 +1,27 @@
import { Client, gql } from "urql";
import { FetchChannelsDocument } from "../../../generated/graphql";
gql`
fragment Channel on Channel {
name
id
slug
}
query FetchChannels {
channels {
...Channel
}
}
`;
export class ChannelsFetcher {
constructor(private client: Client) {}
fetchChannels() {
return this.client
.query(FetchChannelsDocument, {})
.toPromise()
.then((r) => r.data?.channels ?? null);
}
}

View file

@ -0,0 +1,17 @@
import { createClient } from "../../lib/graphql";
import { router } from "../trpc/trpc-server";
import { protectedClientProcedure } from "../trpc/protected-client-procedure";
import { ChannelsFetcher } from "./channels-fetcher";
import { ChannelFragment } from "../../../generated/graphql";
export const channelsRouter = router({
fetch: protectedClientProcedure.query(async ({ ctx, input }): Promise<ChannelFragment[]> => {
const client = createClient(ctx.saleorApiUrl, async () =>
Promise.resolve({ token: ctx.appToken })
);
const fetcher = new ChannelsFetcher(client);
return fetcher.fetchChannels().then((channels) => channels ?? []);
}),
});

View file

@ -0,0 +1,44 @@
import { Client, gql } from "urql";
import { InvoiceCreateDocument } from "../../../generated/graphql";
import { logger } from "../../lib/logger";
gql`
mutation InvoiceCreate($orderId: ID!, $invoiceInput: InvoiceCreateInput!) {
invoiceCreate(input: $invoiceInput, orderId: $orderId) {
errors {
message
}
invoice {
id
}
}
}
`;
export class InvoiceCreateNotifier {
constructor(private client: Client) {}
notifyInvoiceCreated(orderId: string, invoiceNumber: string, invoiceUrl: string) {
logger.info(
{ orderId, invoiceNumber, invoiceUrl },
"Will notify Saleor with invoiceCreate mutation"
);
return this.client
.mutation(InvoiceCreateDocument, {
orderId,
invoiceInput: {
url: invoiceUrl,
number: invoiceNumber,
},
})
.toPromise()
.then((result) => {
logger.info(result.data, "invoiceCreate finished");
if (result.error) {
throw new Error(result.error.message);
}
});
}
}

View file

@ -0,0 +1,16 @@
import { describe, it, expect, vi } from "vitest";
import { hashInvoiceFilename } from "./hash-invoice-filename";
vi.mock("crypto", () => ({
randomUUID() {
return "RANDOM_UUID_MOCK";
},
}));
describe("hashInvoiceFilename", () => {
it("Creates hashed invoice name", () => {
expect(hashInvoiceFilename("1/12/2022", "1234-xxxx-zzzz-1234")).toBe(
"1/12/2022_1234-xxxx-zzzz-1234_RANDOM_UUID_MOCK"
);
});
});

View file

@ -0,0 +1,5 @@
import { randomUUID } from "crypto";
export const hashInvoiceFilename = (invoiceName: string, orderId: string) => {
return `${invoiceName}_${orderId}_${randomUUID()}`;
};

View file

@ -0,0 +1,8 @@
import { describe, expect, it } from "vitest";
import { resolveTempPdfFileLocation } from "./resolve-temp-pdf-file-location";
describe("resolveTempPdfFileLocation", () => {
it("generates path with encoded file name, in case of invoice name contains path segments", () => {
expect(resolveTempPdfFileLocation("12/12/2022-foobar.pdf")).toBe("12%2F12%2F2022-foobar.pdf");
});
});

View file

@ -0,0 +1,8 @@
import { join } from "path";
import invariant from "tiny-invariant";
export const resolveTempPdfFileLocation = (fileName: string) => {
invariant(fileName.includes(".pdf"), `fileName should include pdf extension`);
return join(process.env.TEMP_PDF_STORAGE_DIR ?? "", encodeURIComponent(fileName));
};

View file

@ -0,0 +1,11 @@
import { OrderPayloadFragment } from "../../../generated/graphql";
import { SellerShopConfig } from "../app-configuration/app-config";
export interface InvoiceGenerator {
generate(input: {
order: OrderPayloadFragment;
invoiceNumber: string;
filename: string;
companyAddressData: SellerShopConfig["address"];
}): Promise<void>;
}

View file

@ -0,0 +1,31 @@
import { beforeEach, describe, it } from "vitest";
import { MicroinvoiceInvoiceGenerator } from "./microinvoice-invoice-generator";
import { readFile } from "fs/promises";
import rimraf from "rimraf";
import { mockOrder } from "../../../fixtures/mock-order";
import { getMockAddress } from "../../../fixtures/mock-address";
const cleanup = () => rimraf.sync("test-invoice.pdf");
describe("MicroinvoiceInvoiceGenerator", () => {
beforeEach(() => {
cleanup();
});
// afterEach(() => {
// cleanup();
// });
it("Generates invoice file from Order", async () => {
const instance = new MicroinvoiceInvoiceGenerator();
await instance.generate({
order: mockOrder,
filename: "test-invoice.pdf",
invoiceNumber: "test-123/123",
companyAddressData: getMockAddress(),
});
return readFile("test-invoice.pdf");
});
});

View file

@ -0,0 +1,168 @@
import { InvoiceGenerator } from "../invoice-generator";
import { Order, OrderPayloadFragment } from "../../../../generated/graphql";
import { SellerShopConfig } from "../../app-configuration/app-config";
const Microinvoice = require("microinvoice");
export class MicroinvoiceInvoiceGenerator implements InvoiceGenerator {
constructor(
private settings = {
locale: "en-US",
}
) {}
async generate(input: {
order: OrderPayloadFragment;
invoiceNumber: string;
filename: string;
companyAddressData: SellerShopConfig["address"];
}): Promise<void> {
const { invoiceNumber, order, companyAddressData, filename } = input;
const microinvoiceInstance = new Microinvoice({
style: {
// header: {
// image: {
// path: "./examples/logo.png",
// width: 50,
// height: 19,
// },
// },
},
data: {
invoice: {
name: `Invoice ${invoiceNumber}`,
header: [
{
label: "Order number",
value: order.number,
},
{
label: "Date",
value: Intl.DateTimeFormat(this.settings.locale, {
dateStyle: "medium",
timeStyle: "medium",
}).format(new Date(order.created)),
},
],
currency: order.total.currency,
customer: [
{
label: "Customer",
value: [
`${order.billingAddress?.firstName} ${order.billingAddress?.lastName}`,
order.billingAddress?.companyName,
order.billingAddress?.phone,
`${order.billingAddress?.streetAddress1}`,
`${order.billingAddress?.streetAddress2}`,
`${order.billingAddress?.postalCode} ${order.billingAddress?.city}`,
order.billingAddress?.country.country,
],
},
// {
// label: "Tax Identifier",
// value: "todo",
// },
],
seller: [
{
label: "Seller",
value: [
`${companyAddressData.firstName} ${companyAddressData.lastName}`,
companyAddressData.companyName,
companyAddressData.streetAddress1,
companyAddressData.streetAddress2,
`${companyAddressData.postalCode} ${companyAddressData.city}`,
companyAddressData.cityArea,
companyAddressData.country,
companyAddressData.countryArea,
],
},
// {
// label: "Tax Identifier",
// value: "todo",
// },
],
legal: [
// {
// value: "Lorem ipsum dolor sit amet, consectetur adipiscing elit",
// weight: "bold",
// color: "primary",
// },
// {
// value: "sed do eiusmod tempor incididunt ut labore et dolore magna.",
// weight: "bold",
// color: "secondary",
// },
],
details: {
header: [
{
value: "Description",
},
{
value: "Quantity",
},
{
value: "Subtotal",
},
],
parts: [
...order.lines.map((line) => {
return [
{
value: line.productName,
},
{
value: line.quantity,
},
{
value: line.totalPrice.gross.amount,
price: true,
},
];
}),
[
{
value: order.shippingMethodName,
},
{
value: "-",
},
{
value: order.shippingPrice.gross.amount,
price: true,
},
],
],
total: [
{
label: "Total net",
value: order.total.net.amount,
price: true,
},
{
label: "Tax value",
value: order.total.tax.amount,
price: true,
},
{
label: "Total with tax",
value: order.total.gross.amount,
price: true,
},
],
},
},
},
});
return microinvoiceInstance.generate(filename);
}
}

View file

@ -0,0 +1,23 @@
import { describe, it, expect } from "vitest";
import { InvoiceNumberGenerationStrategy } from "./invoice-number-generator";
describe("InvoiceNumberGenerationStrategies", () => {
describe("localizedDate strategy", () => {
it("Generates proper name for US locale", () => {
const strategy = InvoiceNumberGenerationStrategy.localizedDate("en-US");
/**
* Javascript starts counting months from 0
*/
expect(strategy({ created: new Date(2020, 5, 1).toISOString() })).toBe("6/1/2020");
});
it("Generates proper name for PL locale", () => {
const strategy = InvoiceNumberGenerationStrategy.localizedDate("pl-PL");
/**
* Javascript starts counting months from 0
*/
expect(strategy({ created: new Date(2020, 5, 1).toISOString() })).toBe("1.06.2020");
});
});
});

View file

@ -0,0 +1,19 @@
import {OrderPayloadFragment} from "../../../generated/graphql";
interface IInvoiceNumberGenerationStrategy {
(order: OrderPayloadFragment): string;
}
export const InvoiceNumberGenerationStrategy = {
localizedDate: (locale: string) => (order: Pick<OrderPayloadFragment, 'created'>) => {
const orderCreatedDate = new Date(order.created);
return Intl.DateTimeFormat(locale,).format(orderCreatedDate)
}
} satisfies Record<string, (...args: any[]) => IInvoiceNumberGenerationStrategy>
export class InvoiceNumberGenerator {
generateFromOrder(order: OrderPayloadFragment, strategy: IInvoiceNumberGenerationStrategy): string {
return strategy(order)
}
}

View file

@ -0,0 +1,3 @@
export interface InvoiceUploader {
upload(filePath: string, asName: string): Promise<string>;
}

View file

@ -0,0 +1,47 @@
import { InvoiceUploader } from "./invoice-uploader";
import { Client, gql } from "urql";
import { readFile } from "fs/promises";
import { FileUploadMutation } from "../../../generated/graphql";
/**
* Polyfill file because Node doesnt have it yet
* https://github.com/nodejs/node/commit/916af4ef2d63fe936a369bcf87ee4f69ec7c67ce
*
* Use File instead of Blob so Saleor can understand name
*/
import { File } from "@web-std/file";
const fileUpload = gql`
mutation FileUpload($file: Upload!) {
fileUpload(file: $file) {
errors {
message
}
uploadedFile {
url
}
}
}
`;
export class SaleorInvoiceUploader implements InvoiceUploader {
constructor(private client: Client) {}
upload(filePath: string, asName: string): Promise<string> {
return readFile(filePath).then((file) => {
const blob = new File([file], asName, { type: "application/pdf" });
return this.client
.mutation<FileUploadMutation>(fileUpload, {
file: blob,
})
.toPromise()
.then((r) => {
if (r.data?.fileUpload?.uploadedFile?.url) {
return r.data.fileUpload.uploadedFile.url;
} else {
throw new Error(r.error?.message);
}
});
});
}
}

View file

@ -0,0 +1,43 @@
import { Client, gql } from "urql";
import { ShopInfoDocument, ShopInfoFragment } from "../../../generated/graphql";
gql`
fragment ShopInfo on Shop {
companyAddress {
country {
country
code
}
city
firstName
lastName
streetAddress1
streetAddress2
companyName
phone
postalCode
countryArea
cityArea
}
}
query ShopInfo {
shop {
...ShopInfo
}
}
`;
export interface IShopInfoFetcher {
fetchShopInfo(): Promise<ShopInfoFragment | null>;
}
export class ShopInfoFetcher implements IShopInfoFetcher {
constructor(private client: Client) {}
fetchShopInfo(): Promise<ShopInfoFragment | null> {
return this.client
.query(ShopInfoDocument, {})
.toPromise()
.then((resp) => resp.data?.shop ?? null);
}
}

View file

@ -0,0 +1,117 @@
import { createClient } from "../../lib/graphql";
import { verifyJWT } from "@saleor/app-sdk/verify-jwt";
import { middleware, procedure } from "./trpc-server";
import { saleorApp } from "../../../saleor-app";
import { TRPCError } from "@trpc/server";
import { ProtectedHandlerError } from "@saleor/app-sdk/handlers/next";
import { logger } from "../../lib/logger";
const attachAppToken = middleware(async ({ ctx, next }) => {
logger.debug("attachAppToken middleware");
if (!ctx.saleorApiUrl) {
logger.debug("ctx.saleorApiUrl not found, throwing");
throw new TRPCError({
code: "BAD_REQUEST",
message: "Missing saleorApiUrl in request",
});
}
const authData = await saleorApp.apl.get(ctx.saleorApiUrl);
if (!authData) {
logger.debug("authData not found, throwing 401");
throw new TRPCError({
code: "UNAUTHORIZED",
message: "Missing auth data",
});
}
return next({
ctx: {
appToken: authData.token,
saleorApiUrl: authData.saleorApiUrl,
appId: authData.appId,
},
});
});
const validateClientToken = middleware(async ({ ctx, next, meta }) => {
logger.debug(
{
permissions: meta?.requiredClientPermissions,
},
"Calling validateClientToken middleware with permissions required"
);
if (!ctx.token) {
throw new TRPCError({
code: "INTERNAL_SERVER_ERROR",
message: "Missing token in request. This middleware can be used only in frontend",
});
}
if (!ctx.appId) {
throw new TRPCError({
code: "INTERNAL_SERVER_ERROR",
message: "Missing appId in request. This middleware can be used after auth is attached",
});
}
if (!ctx.saleorApiUrl) {
throw new TRPCError({
code: "INTERNAL_SERVER_ERROR",
message:
"Missing saleorApiUrl in request. This middleware can be used after auth is attached",
});
}
try {
logger.debug("trying to verify JWT token from frontend");
logger.debug({ token: ctx.token ? `${ctx.token[0]}...` : undefined });
await verifyJWT({
appId: ctx.appId,
token: ctx.token,
saleorApiUrl: ctx.saleorApiUrl,
requiredPermissions: meta?.requiredClientPermissions ?? [],
});
} catch (e) {
logger.debug("JWT verification failed, throwing");
throw new ProtectedHandlerError("JWT verification failed: ", "JWT_VERIFICATION_FAILED");
}
return next({
ctx: {
...ctx,
saleorApiUrl: ctx.saleorApiUrl,
},
});
});
/**
* Construct common graphQL client and attach it to the context
*
* Can be used only if called from the frontend (react-query),
* otherwise jwks validation will fail (if createCaller used)
*
* TODO Rethink middleware composition to enable safe server-side router calls
*/
export const protectedClientProcedure = procedure
.use(attachAppToken)
.use(validateClientToken)
.use(async ({ ctx, next }) => {
const client = createClient(ctx.saleorApiUrl, async () =>
Promise.resolve({ token: ctx.appToken })
);
return next({
ctx: {
apiClient: client,
appToken: ctx.appToken,
saleorApiUrl: ctx.saleorApiUrl,
},
});
});

View file

@ -0,0 +1,10 @@
import { channelsRouter } from "../channels/channels.router";
import { router } from "./trpc-server";
import { appConfigurationRouter } from "../app-configuration/app-configuration.router";
export const appRouter = router({
channels: channelsRouter,
appConfiguration: appConfigurationRouter,
});
export type AppRouter = typeof appRouter;

View file

@ -0,0 +1,36 @@
import { httpBatchLink } from "@trpc/client";
import { createTRPCNext } from "@trpc/next";
import { SALEOR_API_URL_HEADER, SALEOR_AUTHORIZATION_BEARER_HEADER } from "@saleor/app-sdk/const";
import { appBridgeInstance } from "../../pages/_app";
import { AppRouter } from "./trpc-app-router";
function getBaseUrl() {
if (typeof window !== "undefined") return "";
if (process.env.VERCEL_URL) return `https://${process.env.VERCEL_URL}`;
return `http://localhost:${process.env.PORT ?? 3000}`;
}
export const trpcClient = createTRPCNext<AppRouter>({
config({ ctx }) {
return {
links: [
httpBatchLink({
url: `${getBaseUrl()}/api/trpc`,
headers() {
return {
/**
* Attach headers from app to client requests, so tRPC can add them to context
*/
[SALEOR_AUTHORIZATION_BEARER_HEADER]: appBridgeInstance?.getState().token,
[SALEOR_API_URL_HEADER]: appBridgeInstance?.getState().saleorApiUrl,
};
},
}),
],
// queryClientConfig: { defaultOptions: { queries: { staleTime: 60 } } },
};
},
ssr: true,
});

View file

@ -0,0 +1,13 @@
import * as trpcNext from "@trpc/server/adapters/next";
import { SALEOR_AUTHORIZATION_BEARER_HEADER, SALEOR_API_URL_HEADER } from "@saleor/app-sdk/const";
import { inferAsyncReturnType } from "@trpc/server";
export const createTrpcContext = async ({ res, req }: trpcNext.CreateNextContextOptions) => {
return {
token: req.headers[SALEOR_AUTHORIZATION_BEARER_HEADER] as string | undefined,
saleorApiUrl: req.headers[SALEOR_API_URL_HEADER] as string | undefined,
appId: undefined as undefined | string,
};
};
export type TrpcContext = inferAsyncReturnType<typeof createTrpcContext>;

View file

@ -0,0 +1,13 @@
import { initTRPC } from "@trpc/server";
import { TrpcContext } from "./trpc-context";
import { AppPermission } from "@saleor/app-sdk/types";
interface Meta {
requiredClientPermissions?: AppPermission[];
}
const t = initTRPC.context<TrpcContext>().meta<Meta>().create();
export const router = t.router;
export const procedure = t.procedure;
export const middleware = t.middleware;

View file

@ -0,0 +1,21 @@
import { makeStyles } from "@saleor/macaw-ui";
import { PropsWithChildren } from "react";
const useStyles = makeStyles({
root: {
display: "grid",
gridTemplateColumns: "280px auto 280px",
alignItems: "start",
gap: 32,
maxWidth: 1180,
margin: "0 auto",
},
});
type Props = PropsWithChildren<{}>;
export const AppColumnsLayout = ({ children }: Props) => {
const styles = useStyles();
return <div className={styles.root}>{children}</div>;
};

View file

@ -0,0 +1,51 @@
import { makeStyles } from "@saleor/macaw-ui";
import { ReactNode } from "react";
import { Paper, PaperProps } from "@material-ui/core";
import clsx from "clsx";
const useStyles = makeStyles((theme) => ({
root: {
height: 96,
padding: "0 32px",
display: "flex",
alignItems: "center",
justifyContent: "space-between",
},
leftColumn: {
marginRight: "auto",
},
rightColumn: {},
iconColumn: {
marginRight: 24,
},
appName: { fontSize: 24, margin: 0 },
appAuthor: {
fontSize: 12,
textTransform: "uppercase",
color: theme.palette.text.secondary,
fontWeight: 500,
margin: 0,
},
}));
type Props = {
name: string;
author: string;
rightColumnContent?: ReactNode;
icon?: ReactNode;
} & PaperProps;
export const MainBar = ({ name, author, rightColumnContent, className, icon }: Props) => {
const styles = useStyles();
return (
<Paper elevation={0} className={clsx(styles.root, className)}>
{icon && <div className={styles.iconColumn}>{icon}</div>}
<div className={styles.leftColumn}>
<h1 className={styles.appName}>{name}</h1>
<h1 className={styles.appAuthor}>{author}</h1>
</div>
<div className={styles.rightColumn}>{rightColumnContent}</div>
</Paper>
);
};

View file

@ -0,0 +1,60 @@
import "../styles/globals.css";
import { Theme } from "@material-ui/core/styles";
import { AppBridge, AppBridgeProvider } from "@saleor/app-sdk/app-bridge";
import { RoutePropagator } from "@saleor/app-sdk/app-bridge/next";
import { ThemeProvider as MacawUIThemeProvider } from "@saleor/macaw-ui";
import React, { PropsWithChildren, useEffect } from "react";
import { AppProps } from "next/app";
import GraphQLProvider from "../providers/GraphQLProvider";
import { ThemeSynchronizer } from "../lib/theme-synchronizer";
import { NoSSRWrapper } from "../lib/no-ssr-wrapper";
import { trpcClient } from "../modules/trpc/trpc-client";
const themeOverrides: Partial<Theme> = {
/**
* You can override MacawUI theme here
*/
};
/**
* Ensure instance is a singleton.
* TODO: This is React 18 issue, consider hiding this workaround inside app-sdk
*/
export const appBridgeInstance = typeof window !== "undefined" ? new AppBridge() : undefined;
/**
* That's a hack required by Macaw-UI incompatibility with React@18
*/
const ThemeProvider = MacawUIThemeProvider as React.FC<
PropsWithChildren<{ overrides?: Partial<Theme>; ssr: boolean }>
>;
function NextApp({ Component, pageProps }: AppProps) {
/**
* Configure JSS (used by MacawUI) for SSR. If Macaw is not used, can be removed.
*/
useEffect(() => {
const jssStyles = document.querySelector("#jss-server-side");
if (jssStyles) {
jssStyles?.parentElement?.removeChild(jssStyles);
}
}, []);
return (
<NoSSRWrapper>
<AppBridgeProvider appBridgeInstance={appBridgeInstance}>
<GraphQLProvider>
<ThemeProvider overrides={themeOverrides} ssr={false}>
<ThemeSynchronizer />
<RoutePropagator />
<Component {...pageProps} />
</ThemeProvider>
</GraphQLProvider>
</AppBridgeProvider>
</NoSSRWrapper>
);
}
export default trpcClient.withTRPC(NextApp);

View file

@ -0,0 +1,39 @@
/**
* NOTE: This requires `@sentry/nextjs` version 7.3.0 or higher.
*
* NOTE: If using this with `next` version 12.2.0 or lower, uncomment the
* penultimate line in `CustomErrorComponent`.
*
* This page is loaded by Nextjs:
* - on the server, when data-fetching methods throw or reject
* - on the client, when `getInitialProps` throws or rejects
* - on the client, when a React lifecycle method throws or rejects, and it's
* caught by the built-in Nextjs error boundary
*
* See:
* - https://nextjs.org/docs/basic-features/data-fetching/overview
* - https://nextjs.org/docs/api-reference/data-fetching/get-initial-props
* - https://reactjs.org/docs/error-boundaries.html
*/
import * as Sentry from '@sentry/nextjs';
import NextErrorComponent from 'next/error';
const CustomErrorComponent = props => {
// If you're using a Nextjs version prior to 12.2.1, uncomment this to
// compensate for https://github.com/vercel/next.js/issues/8592
// Sentry.captureUnderscoreErrorException(props);
return <NextErrorComponent statusCode={props.statusCode} />;
};
CustomErrorComponent.getInitialProps = async contextData => {
// In case this is running in a serverless function, await this in order to give Sentry
// time to send the error before the lambda exits
await Sentry.captureUnderscoreErrorException(contextData);
// This will contain the status code of the response
return NextErrorComponent.getInitialProps(contextData);
};
export default CustomErrorComponent;

View file

@ -0,0 +1,22 @@
import { createManifestHandler } from "@saleor/app-sdk/handlers/next";
import { AppManifest } from "@saleor/app-sdk/types";
import packageJson from "../../../package.json";
import { invoiceRequestedWebhook } from "./webhooks/invoice-requested";
export default createManifestHandler({
async manifestFactory(context) {
const manifest: AppManifest = {
name: packageJson.name,
tokenTargetUrl: `${context.appBaseUrl}/api/register`,
appUrl: context.appBaseUrl,
permissions: ["MANAGE_ORDERS"],
id: "app.saleor.invoices",
version: packageJson.version,
webhooks: [invoiceRequestedWebhook.getWebhookManifest(context.appBaseUrl)],
extensions: [],
};
return manifest;
},
});

View file

@ -0,0 +1,28 @@
import { createAppRegisterHandler } from "@saleor/app-sdk/handlers/next";
import { saleorApp } from "../../../saleor-app";
const allowedUrlsPattern = process.env.ALLOWED_DOMAIN_PATTERN;
/**
* Required endpoint, called by Saleor to install app.
* It will exchange tokens with app, so saleorApp.apl will contain token
*/
export default createAppRegisterHandler({
apl: saleorApp.apl,
/**
* Prohibit installation from Saleors other than specified by the regex.
* Regex source is ENV so if ENV is not set, all installations will be allowed.
*/
allowedSaleorUrls: [
(url) => {
if (allowedUrlsPattern) {
const regex = new RegExp(allowedUrlsPattern);
return regex.test(url);
}
return true;
},
],
});

View file

@ -0,0 +1,8 @@
import * as trpcNext from "@trpc/server/adapters/next";
import { createTrpcContext } from "../../../modules/trpc/trpc-context";
import { appRouter } from "../../../modules/trpc/trpc-app-router";
export default trpcNext.createNextApiHandler({
router: appRouter,
createContext: createTrpcContext,
});

View file

@ -0,0 +1,225 @@
import { NextWebhookApiHandler, SaleorAsyncWebhook } from "@saleor/app-sdk/handlers/next";
import { gql } from "urql";
import { saleorApp } from "../../../../saleor-app";
import {
InvoiceRequestedPayloadFragment,
OrderPayloadFragment,
} from "../../../../generated/graphql";
import { createClient } from "../../../lib/graphql";
import { SaleorInvoiceUploader } from "../../../modules/invoice-uploader/saleor-invoice-uploader";
import { InvoiceCreateNotifier } from "../../../modules/invoice-create-notifier/invoice-create-notifier";
import {
InvoiceNumberGenerationStrategy,
InvoiceNumberGenerator,
} from "../../../modules/invoice-number-generator/invoice-number-generator";
import { MicroinvoiceInvoiceGenerator } from "../../../modules/invoice-generator/microinvoice/microinvoice-invoice-generator";
import { hashInvoiceFilename } from "../../../modules/invoice-file-name/hash-invoice-filename";
import { resolveTempPdfFileLocation } from "../../../modules/invoice-file-name/resolve-temp-pdf-file-location";
import { appConfigurationRouter } from "../../../modules/app-configuration/app-configuration.router";
import { createLogger } from "../../../lib/logger";
import { GetAppConfigurationService } from "../../../modules/app-configuration/get-app-configuration.service";
const OrderPayload = gql`
fragment Address on Address {
id
country {
country
code
}
companyName
cityArea
countryArea
streetAddress1
streetAddress2
postalCode
phone
firstName
lastName
city
}
fragment Money on Money {
amount
currency
}
fragment TaxedMoney on TaxedMoney {
currency
gross {
...Money
}
net {
...Money
}
tax {
...Money
}
}
fragment OrderPayload on Order {
shippingPrice {
...TaxedMoney
}
shippingMethodName
number
id
billingAddress {
...Address
}
created
fulfillments {
created
}
status
number
total {
...TaxedMoney
}
channel {
slug
}
lines {
productName
variantName
quantity
totalPrice {
...TaxedMoney
}
}
shippingPrice {
...TaxedMoney
}
shippingMethodName
}
`;
export const InvoiceCreatedPayloadFragment = gql`
${OrderPayload}
fragment InvoiceRequestedPayload on InvoiceRequested {
invoice {
id
}
order {
... on Order {
...OrderPayload
}
}
}
`;
const InvoiceRequestedSubscription = gql`
${InvoiceCreatedPayloadFragment}
subscription InvoiceRequested {
event {
...InvoiceRequestedPayload
}
}
`;
export const invoiceRequestedWebhook = new SaleorAsyncWebhook<InvoiceRequestedPayloadFragment>({
name: "Invoice requested",
webhookPath: "api/webhooks/invoice-requested",
asyncEvent: "INVOICE_REQUESTED",
apl: saleorApp.apl,
subscriptionQueryAst: InvoiceRequestedSubscription,
});
const invoiceNumberGenerator = new InvoiceNumberGenerator();
export const handler: NextWebhookApiHandler<InvoiceRequestedPayloadFragment> = async (
req,
res,
context
) => {
const { authData, payload, baseUrl } = context;
const logger = createLogger({ domain: authData.saleorApiUrl, url: baseUrl });
const order = payload.order;
logger.info({ orderId: order.id }, "Received event INVOICE_REQUESTED");
logger.debug(order, "Order from payload:");
const orderId = order.id;
/**
* TODO -> should generate from generation date or order date?
*/
const invoiceName = invoiceNumberGenerator.generateFromOrder(
order as OrderPayloadFragment,
InvoiceNumberGenerationStrategy.localizedDate("en-US") // todo connect locale -> where from?
);
logger.debug({ invoiceName }, "Generated invoice name");
if (!authData) {
logger.error("Auth data not found");
return res.status(403).json({
error: `Could not find auth data. Check if app is installed.`,
});
}
try {
const client = createClient(authData.saleorApiUrl, async () =>
Promise.resolve({ token: authData.token })
);
const hashedInvoiceName = hashInvoiceFilename(invoiceName, orderId);
logger.debug({ hashedInvoiceName });
const hashedInvoiceFileName = `${hashedInvoiceName}.pdf`;
const tempPdfLocation = resolveTempPdfFileLocation(hashedInvoiceFileName);
logger.debug({ tempPdfLocation });
const appConfig = await new GetAppConfigurationService({
saleorApiUrl: authData.saleorApiUrl,
apiClient: client,
}).getConfiguration();
await new MicroinvoiceInvoiceGenerator()
.generate({
order,
invoiceNumber: invoiceName,
filename: tempPdfLocation,
companyAddressData: appConfig.shopConfigPerChannel[order.channel.slug]?.address,
})
.catch((err) => {
logger.error(err, "Error generating invoice");
return res.status(500).json({
error: "Error generating invoice",
});
});
const uploader = new SaleorInvoiceUploader(client);
const uploadedFileUrl = await uploader.upload(tempPdfLocation, `${invoiceName}.pdf`);
logger.info({ uploadedFileUrl }, "Uploaded file to storage, will notify Saleor now");
await new InvoiceCreateNotifier(client).notifyInvoiceCreated(
orderId,
invoiceName,
uploadedFileUrl
);
} catch (e) {
logger.error(e);
return res.status(500).json({
error: (e as any)?.message ?? "Error",
});
}
logger.info("Success");
return res.status(200).end();
};
export default invoiceRequestedWebhook.createHandler(handler);
export const config = {
api: {
bodyParser: false,
},
};

View file

@ -0,0 +1,94 @@
import { NextPage } from "next";
import React, { useEffect } from "react";
import { ChannelsConfiguration } from "../modules/app-configuration/ui/channels-configuration";
import { trpcClient } from "../modules/trpc/trpc-client";
import { useRouter } from "next/router";
import { MainBar } from "../modules/ui/main-bar";
import { Button, makeStyles } from "@saleor/macaw-ui";
import { GitHub, OfflineBoltOutlined } from "@material-ui/icons";
import { actions, useAppBridge } from "@saleor/app-sdk/app-bridge";
import appIcon from "../app-invoices-icon.svg";
import Image from "next/image";
const useStyles = makeStyles({
buttonsGrid: { display: "flex", gap: 10 },
topBar: {
marginBottom: 32,
},
appIconContainer: {
background: `rgb(227, 149, 60)`,
padding: 10,
borderRadius: "50%",
width: 50,
height: 50,
},
});
const AppIcon = () => {
const styles = useStyles();
return (
<div className={styles.appIconContainer}>
<Image width={30} height={30} alt="icon" src={appIcon} />
</div>
);
};
const ConfigurationPage: NextPage = () => {
const styles = useStyles();
const channels = trpcClient.channels.fetch.useQuery();
const router = useRouter();
const { appBridge } = useAppBridge();
const openInNewTab = (url: string) => {
appBridge?.dispatch(
actions.Redirect({
to: url,
newContext: true,
})
);
};
useEffect(() => {
if (channels.isSuccess && channels.data.length === 0) {
router.push("/not-ready");
}
}, [channels.data, channels.isSuccess]);
return (
<div>
<MainBar
icon={<AppIcon />}
className={styles.topBar}
name="Saleor Invoices"
author="By Saleor Commerce"
rightColumnContent={
<div className={styles.buttonsGrid}>
<Button
variant="secondary"
startIcon={<GitHub />}
onClick={() => {
openInNewTab("https://github.com/saleor/saleor-app-invoices");
}}
>
Repository
</Button>
<Button
startIcon={<OfflineBoltOutlined />}
variant="secondary"
onClick={() => {
openInNewTab("https://github.com/saleor/apps/discussions");
}}
>
Request a feature
</Button>
</div>
}
/>
<ChannelsConfiguration />
</div>
);
};
export default ConfigurationPage;

View file

@ -0,0 +1,33 @@
import { NextPage } from "next";
import { useAppBridge } from "@saleor/app-sdk/app-bridge";
import { useEffect } from "react";
import { useIsMounted } from "usehooks-ts";
import { useRouter } from "next/router";
import { isInIframe } from "../lib/is-in-iframe";
import { LinearProgress } from "@material-ui/core";
const IndexPage: NextPage = () => {
const { appBridgeState } = useAppBridge();
const isMounted = useIsMounted();
const { replace } = useRouter();
useEffect(() => {
if (isMounted() && appBridgeState?.ready) {
replace("/configuration");
}
}, [isMounted, appBridgeState?.ready]);
if (isInIframe()) {
return <LinearProgress />;
}
return (
<div>
<h1>Saleor Invoices</h1>
<p>This is Saleor App that allows invoices generation</p>
<p>Install app in your Saleor instance and open in with Dashboard</p>
</div>
);
};
export default IndexPage;

View file

@ -0,0 +1,36 @@
import { AlertBase, Button } from "@saleor/macaw-ui";
import React from "react";
import { Typography } from "@material-ui/core";
import { actions, useAppBridge } from "@saleor/app-sdk/app-bridge";
const NotReadyPage = () => {
const { appBridge } = useAppBridge();
return (
<div>
<h1>Saleor Invoices App</h1>
<AlertBase variant="error">
<Typography variant="h3" paragraph>
App can not be used
</Typography>
<Typography paragraph>
To configure Invoices App you need to create at least 1 channel
</Typography>
<Button
variant="primary"
onClick={() => {
appBridge?.dispatch(
actions.Redirect({
to: `/channels/add`,
})
);
}}
>
Set up channel
</Button>
</AlertBase>
</div>
);
};
export default NotReadyPage;

View file

@ -0,0 +1,21 @@
import { useAppBridge } from "@saleor/app-sdk/app-bridge";
import { PropsWithChildren } from "react";
import { Provider } from "urql";
import { createClient } from "../lib/graphql";
function GraphQLProvider(props: PropsWithChildren<{}>) {
const { appBridgeState } = useAppBridge();
if (!appBridgeState?.saleorApiUrl) {
return <div {...props}></div>;
}
const client = createClient(appBridgeState?.saleorApiUrl, async () =>
Promise.resolve({ token: appBridgeState?.token! })
);
return <Provider value={client} {...props} />;
}
export default GraphQLProvider;

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

View file

@ -0,0 +1,4 @@
<svg width="283" height="64" viewBox="0 0 283 64" fill="none"
xmlns="http://www.w3.org/2000/svg">
<path d="M141.04 16c-11.04 0-19 7.2-19 18s8.96 18 20 18c6.67 0 12.55-2.64 16.19-7.09l-7.65-4.42c-2.02 2.21-5.09 3.5-8.54 3.5-4.79 0-8.86-2.5-10.37-6.5h28.02c.22-1.12.35-2.28.35-3.5 0-10.79-7.96-17.99-19-17.99zm-9.46 14.5c1.25-3.99 4.67-6.5 9.45-6.5 4.79 0 8.21 2.51 9.45 6.5h-18.9zM248.72 16c-11.04 0-19 7.2-19 18s8.96 18 20 18c6.67 0 12.55-2.64 16.19-7.09l-7.65-4.42c-2.02 2.21-5.09 3.5-8.54 3.5-4.79 0-8.86-2.5-10.37-6.5h28.02c.22-1.12.35-2.28.35-3.5 0-10.79-7.96-17.99-19-17.99zm-9.45 14.5c1.25-3.99 4.67-6.5 9.45-6.5 4.79 0 8.21 2.51 9.45 6.5h-18.9zM200.24 34c0 6 3.92 10 10 10 4.12 0 7.21-1.87 8.8-4.92l7.68 4.43c-3.18 5.3-9.14 8.49-16.48 8.49-11.05 0-19-7.2-19-18s7.96-18 19-18c7.34 0 13.29 3.19 16.48 8.49l-7.68 4.43c-1.59-3.05-4.68-4.92-8.8-4.92-6.07 0-10 4-10 10zm82.48-29v46h-9V5h9zM36.95 0L73.9 64H0L36.95 0zm92.38 5l-27.71 48L73.91 5H84.3l17.32 30 17.32-30h10.39zm58.91 12v9.69c-1-.29-2.06-.49-3.2-.49-5.81 0-10 4-10 10V51h-9V17h9v9.2c0-5.08 5.91-9.2 13.2-9.2z" fill="#000"/>
</svg>

After

Width:  |  Height:  |  Size: 1.1 KiB

View file

@ -0,0 +1 @@
export {};

View file

@ -0,0 +1,16 @@
body {
font-family: Inter, -apple-system, "system-ui", "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell,
"Fira Sans", "Droid Sans", "Helvetica Neue", sans-serif;
color: #111;
padding: 1rem 2rem;
}
code {
background: #f6f8fa;
border: 1px solid #eaeaea;
border-radius: 5px;
display: inline-block;
padding: 0.1em 0.2em;
font-family: Menlo, Monaco, Lucida Console, Liberation Mono, DejaVu Sans Mono,
Bitstream Vera Sans Mono, Courier New, monospace;
}

View file

@ -0,0 +1,20 @@
{
"compilerOptions": {
"target": "es5",
"lib": ["dom", "dom.iterable", "esnext"],
"allowJs": true,
"skipLibCheck": true,
"strict": true,
"forceConsistentCasingInFileNames": true,
"noEmit": true,
"esModuleInterop": true,
"module": "esnext",
"moduleResolution": "node",
"resolveJsonModule": true,
"isolatedModules": true,
"jsx": "preserve",
"incremental": true
},
"include": ["next-env.d.ts", "**/*.ts", "**/*.tsx"],
"exclude": ["node_modules"]
}

View file

@ -0,0 +1,16 @@
import react from "@vitejs/plugin-react";
import { defineConfig } from "vitest/config";
// https://vitejs.dev/config/
export default defineConfig({
plugins: [react()],
test: {
environment: "jsdom",
setupFiles: "./src/setup-tests.ts",
css: false,
coverage: {
provider: "c8",
reporter: ["text-summary", "cobertura"],
},
},
});

File diff suppressed because it is too large Load diff