@reactionary/source 0.0.27

package/providers/algolia/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "importHelpers": true,
+    "noImplicitOverride": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true,
+    "noPropertyAccessFromIndexSignature": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    },
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}

package/providers/algolia/tsconfig.lib.json

@@ -0,0 +1,10 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "declaration": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["jest.config.ts", "src/**/*.spec.ts", "src/**/*.test.ts"]
+}

package/providers/algolia/tsconfig.spec.json

@@ -0,0 +1,15 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "module": "commonjs",
+    "moduleResolution": "node10",
+    "types": ["jest", "node"]
+  },
+  "include": [
+    "jest.config.ts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.d.ts"
+  ]
+}

package/providers/commercetools/README.md

@@ -0,0 +1,11 @@
+# provider-commercetools
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build provider-commercetools` to build the library.
+
+## Running unit tests
+
+Run `nx test provider-commercetools` to execute the unit tests via [Jest](https://jestjs.io).

package/providers/commercetools/eslint.config.mjs

@@ -0,0 +1,22 @@
+import baseConfig from '../../eslint.config.mjs';
+
+export default [
+  ...baseConfig,
+  {
+    files: ['**/*.json'],
+    rules: {
+      '@nx/dependency-checks': [
+        'error',
+        {
+          ignoredFiles: [
+            '{projectRoot}/eslint.config.{js,cjs,mjs}',
+            '{projectRoot}/esbuild.config.{js,ts,mjs,mts}',
+          ],
+        },
+      ],
+    },
+    languageOptions: {
+      parser: await import('jsonc-eslint-parser'),
+    },
+  },
+];

package/providers/commercetools/jest.config.ts

@@ -0,0 +1,10 @@
+export default {
+  displayName: 'provider-commercetools',
+  preset: '../../jest.preset.js',
+  testEnvironment: 'node',
+  transform: {
+    '^.+\\.[tj]s$': ['ts-jest', { tsconfig: '<rootDir>/tsconfig.spec.json' }],
+  },
+  moduleFileExtensions: ['ts', 'js', 'html'],
+  coverageDirectory: '../../coverage/providers/commercetools',
+};

package/providers/commercetools/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "@reactionary/provider-commercetools",
+  "version": "0.0.1",
+  "dependencies": {
+    "@reactionary/core": "0.0.1",
+    "zod": "4.0.0-beta.20250430T185432",
+    "@commercetools/ts-client": "^3.2.2",
+    "@commercetools/platform-sdk": "^8.8.0"
+  }
+}

package/providers/commercetools/project.json

@@ -0,0 +1,33 @@
+{
+  "name": "provider-commercetools",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "providers/commercetools/src",
+  "projectType": "library",
+  "release": {
+    "version": {
+      "currentVersionResolver": "git-tag",
+      "fallbackCurrentVersionResolver": "disk",
+      "preserveLocalDependencyProtocols": false,
+      "manifestRootsToUpdate": ["dist/{projectRoot}"]
+    }
+  },
+  "tags": [],
+  "targets": {
+    "build": {
+      "executor": "@nx/esbuild:esbuild",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "outputPath": "dist/providers/commercetools",
+        "main": "providers/commercetools/src/index.ts",
+        "tsConfig": "providers/commercetools/tsconfig.lib.json",
+        "assets": ["providers/commercetools/*.md"],
+        "format": ["esm"]
+      }
+    },
+    "nx-release-publish": {
+      "options": {
+        "packageRoot": "dist/{projectRoot}"
+      }
+    }
+  }
+}

package/providers/commercetools/src/core/client.ts

@@ -0,0 +1,152 @@
+import { ClientBuilder } from '@commercetools/ts-client';
+import { createApiBuilderFromCtpClient } from '@commercetools/platform-sdk';
+import { CommercetoolsConfiguration } from '../schema/configuration.schema';
+import { Session } from '@reactionary/core';
+
+const ANONYMOUS_SCOPES = ['view_published_products', 'manage_shopping_lists', 'view_shipping_methods', 'manage_customers', 'view_product_selections', 'view_categories', 'view_project_settings', 'manage_order_edits', 'view_sessions', 'view_standalone_prices', 'manage_orders', 'view_tax_categories', 'view_cart_discounts', 'view_discount_codes', 'create_anonymous_token', 'manage_sessions', 'view_products', 'view_types'];
+const GUEST_SCOPES = [...ANONYMOUS_SCOPES];
+const REGISTERED_SCOPES = [...GUEST_SCOPES];
+
+export class CommercetoolsClient {
+  protected config: CommercetoolsConfiguration;
+
+  constructor(config: CommercetoolsConfiguration) {
+    this.config = config;
+  }
+
+  public getClient(token?: string) {
+    if (token) {
+      return this.createClientWithToken(token);
+    }
+
+    return this.createAnonymousClient();
+  }
+
+  public async login(username: string, password: string) {
+    const scopes = REGISTERED_SCOPES.map(
+      (scope) => `${scope}:${this.config.projectKey}`
+    ).join(' ');
+    const queryParams = new URLSearchParams({
+      grant_type: 'password',
+      username: username,
+      password: password,
+      scope: scopes,
+    });
+    const url = `${this.config.authUrl}/oauth/${
+      this.config.projectKey
+    }/customers/token?${queryParams.toString()}`;
+    const headers = {
+      Authorization:
+        'Basic ' + btoa(this.config.clientId + ':' + this.config.clientSecret),
+    };
+
+    const remote = await fetch(url, { method: 'POST', headers });
+    const json = await remote.json();
+
+    return json;
+  }
+
+  public async guest() {
+    const scopes = GUEST_SCOPES.map(
+      (scope) => `${scope}:${this.config.projectKey}`
+    ).join(' ');
+    const queryParams = new URLSearchParams({
+      grant_type: 'client_credentials',
+      scope: scopes,
+    });
+    const url = `${this.config.authUrl}/oauth/${
+      this.config.projectKey
+    }/anonymous/token?${queryParams.toString()}`;
+    const headers = {
+      Authorization:
+        'Basic ' + btoa(this.config.clientId + ':' + this.config.clientSecret),
+    };
+
+    const remote = await fetch(url, { method: 'POST', headers });
+    const json = await remote.json();
+
+    return json;
+  }
+
+  public async logout(token: string) {
+    const queryParams = new URLSearchParams({
+      token: token,
+      token_type_hint: 'access_token',
+    });
+    const url = `${
+      this.config.authUrl
+    }/oauth/token/revoke?${queryParams.toString()}`;
+    const headers = {
+      Authorization:
+        'Basic ' + btoa(this.config.clientId + ':' + this.config.clientSecret),
+    };
+
+    const remote = await fetch(url, { method: 'POST', headers });
+
+    return remote;
+  }
+
+  public async introspect(token: string) {
+    const queryParams = new URLSearchParams({
+      token,
+    });
+    const url = `${this.config.authUrl}/oauth/introspect?` + queryParams;
+    const headers = {
+      Authorization:
+        'Basic ' + btoa(this.config.clientId + ':' + this.config.clientSecret),
+    };
+
+    const remote = await fetch(url, { method: 'POST', headers });
+    const json = await remote.json();
+
+    return json;
+  }
+
+  public createAnonymousClient() {
+    const scopes = ANONYMOUS_SCOPES.map(
+      (scope) => `${scope}:${this.config.projectKey}`
+    ).join(' ');
+    const builder = this.createBaseClientBuilder().withClientCredentialsFlow({
+      host: this.config.authUrl,
+      projectKey: this.config.projectKey,
+      credentials: {
+        clientId: this.config.clientId,
+        clientSecret: this.config.clientSecret,
+      },
+      scopes: [scopes],
+    });
+
+    return createApiBuilderFromCtpClient(builder.build());
+  }
+
+  protected createClientWithToken(token: string) {
+    const builder = this.createBaseClientBuilder().withExistingTokenFlow(`Bearer ${ token }`, { force: true });
+
+    return createApiBuilderFromCtpClient(builder.build());
+  }
+
+  protected createBaseClientBuilder() {
+    const builder = new ClientBuilder()
+      .withProjectKey(this.config.projectKey)
+      .withQueueMiddleware({
+        concurrency: 20,
+      })
+      .withHttpMiddleware({
+        retryConfig: {
+          backoff: true,
+          maxRetries: 3,
+          retryDelay: 500,
+          retryOnAbort: true,
+          retryCodes: [500, 429, 420],
+          maxDelay: 5000,
+        },
+        enableRetry: true,
+        includeResponseHeaders: true,
+        maskSensitiveHeaderData: false,
+        host: this.config.apiUrl,
+        httpClient: fetch,
+      });
+
+    return builder;
+  }
+}

package/providers/commercetools/src/core/initialize.ts

@@ -0,0 +1,40 @@
+import { CartMutationSchema, CartQuerySchema, CartSchema, Client, IdentityMutationSchema, IdentityQuerySchema, IdentitySchema, InventoryQuerySchema, InventorySchema, PriceMutationSchema, PriceQuerySchema, PriceSchema, ProductMutationSchema, ProductQuerySchema, ProductSchema, SearchMutationSchema, SearchQuerySchema, SearchResultSchema } from "@reactionary/core";
+import { CommercetoolsCapabilities } from "../schema/capabilities.schema";
+import { CommercetoolsSearchProvider } from "../providers/search.provider";
+import { CommercetoolsProductProvider } from '../providers/product.provider';
+import { CommercetoolsConfiguration } from "../schema/configuration.schema";
+import { CommercetoolsIdentityProvider } from "../providers/identity.provider";
+import { CommercetoolsCartProvider } from "../providers/cart.provider";
+import { CommercetoolsInventoryProvider } from "../providers/inventory.provider";
+import { CommercetoolsPriceProvider } from "../providers/price.provider";
+import { InventoryMutationSchema } from "core/src/schemas/mutations/inventory.mutation";
+
+export function withCommercetoolsCapabilities(configuration: CommercetoolsConfiguration, capabilities: CommercetoolsCapabilities) {
+    const client: Partial<Client> = {};
+
+    if (capabilities.product) {
+        client.product = new CommercetoolsProductProvider(configuration, ProductSchema, ProductQuerySchema, ProductMutationSchema);
+    }
+
+    if (capabilities.search) {
+        client.search = new CommercetoolsSearchProvider(configuration, SearchResultSchema, SearchQuerySchema, SearchMutationSchema);
+    }
+
+    if (capabilities.identity) {
+        client.identity = new CommercetoolsIdentityProvider(configuration, IdentitySchema, IdentityQuerySchema, IdentityMutationSchema);
+    }
+
+    if (capabilities.cart) {
+        client.cart = new CommercetoolsCartProvider(configuration, CartSchema, CartQuerySchema, CartMutationSchema);
+    }
+
+    if (capabilities.inventory) {
+        client.inventory = new CommercetoolsInventoryProvider(configuration, InventorySchema, InventoryQuerySchema, InventoryMutationSchema);
+    }
+
+    if (capabilities.price) {
+        client.price = new CommercetoolsPriceProvider(configuration, PriceSchema, PriceQuerySchema, PriceMutationSchema);
+    }
+
+    return client;
+}

package/providers/commercetools/src/index.ts

@@ -0,0 +1,12 @@
+export * from './core/client';
+export * from './core/initialize';
+
+export * from './providers/cart.provider';
+export * from './providers/identity.provider';
+export * from './providers/inventory.provider';
+export * from './providers/price.provider';
+export * from './providers/product.provider';
+export * from './providers/search.provider';
+
+export * from './schema/capabilities.schema';
+export * from './schema/configuration.schema';

package/providers/commercetools/src/providers/cart.provider.ts

@@ -0,0 +1,223 @@
+import {
+  Cart,
+  CartItemSchema,
+  CartMutation,
+  CartMutationItemAdd,
+  CartMutationItemQuantityChange,
+  CartMutationItemRemove,
+  CartProvider,
+  CartQuery,
+  Session,
+} from '@reactionary/core';
+import { CommercetoolsConfiguration } from '../schema/configuration.schema';
+import { z } from 'zod';
+import { CommercetoolsClient } from '../core/client';
+import { Cart as CTCart } from '@commercetools/platform-sdk';
+
+export class CommercetoolsCartProvider<
+  T extends Cart = Cart,
+  Q extends CartQuery = CartQuery,
+  M extends CartMutation = CartMutation
+> extends CartProvider<T, Q, M> {
+  protected config: CommercetoolsConfiguration;
+
+  constructor(
+    config: CommercetoolsConfiguration,
+    schema: z.ZodType<T>,
+    querySchema: z.ZodType<Q, Q>,
+    mutationSchema: z.ZodType<M, M>
+  ) {
+    super(schema, querySchema, mutationSchema);
+
+    this.config = config;
+  }
+
+  protected override async fetch(queries: Q[], session: Session): Promise<T[]> {
+    const results = [];
+
+    for (const query of queries) {
+      if (query.cart.key) {
+        const client = this.getClient(session);
+        const remote = await client
+          .withId({ ID: query.cart.key })
+          .get()
+          .execute();
+
+        const result = this.composeCart(remote.body);
+
+        results.push(result);
+      }
+    }
+
+    return results;
+  }
+  protected override async process(
+    mutations: M[],
+    session: Session
+  ): Promise<T> {
+    let cart = this.newModel();
+
+    /**
+     * TODO: Optimize this, since CT as a remote provider allows us to forward multiple changes
+     * at once. As part of the current rewrite, this is mostly preserved as was before.
+     */
+    for (const mutation of mutations) {
+      switch (mutation.mutation) {
+        case 'add':
+          cart = await this.add(mutation, session);
+          break;
+        case 'adjustQuantity':
+          cart = await this.adjust(mutation, session);
+          break;
+        case 'remove':
+          cart = await this.remove(mutation, session);
+      }
+    }
+
+    return cart;
+  }
+
+  protected async adjust(
+    payload: CartMutationItemQuantityChange,
+    session: Session
+  ): Promise<T> {
+    const client = this.getClient(session);
+
+    // TODO: Consider whether we can skip this step by proxying the version as part of the CommercetoolsCartIdentifier
+    const existing = await client
+      .withId({ ID: payload.cart.key })
+      .get()
+      .execute();
+
+    const remote = await client
+      .withId({ ID: payload.cart.key })
+      .post({
+        body: {
+          version: existing.body.version,
+          actions: [
+            {
+              action: 'changeLineItemQuantity',
+              lineItemId: payload.item.key,
+              quantity: payload.quantity,
+            },
+          ],
+        },
+      })
+      .execute();
+
+    const result = this.composeCart(remote.body);
+
+    return result;
+  }
+
+    protected async add(
+    payload: CartMutationItemAdd,
+    session: Session
+  ): Promise<T> {
+    const client = this.getClient(session);
+
+    let id = payload.cart.key;
+    let version = 0;
+
+    if (!id) {
+      const remoteCart = await client
+        .post({
+          body: {
+            currency: 'USD',
+            country: 'US',
+          },
+        })
+        .execute();
+
+      id = remoteCart.body.id;
+      version = remoteCart.body.version;
+    } else {
+        // TODO: Consider whether we can skip this step by proxying the version as part of the CommercetoolsCartIdentifier
+        const existing = await client.withId({ ID: payload.cart.key }).get().execute();
+        
+        version = existing.body.version;
+    }
+
+    const remoteAdd = await client
+      .withId({ ID: id })
+      .post({
+        body: {
+          version: version,
+          actions: [
+            {
+              action: 'addLineItem',
+              quantity: payload.quantity,
+              productId: payload.product.key,
+            },
+          ],
+        },
+      })
+      .execute();
+
+    const result = this.composeCart(remoteAdd.body);
+
+    return result;
+  }
+
+  protected async remove(
+    payload: CartMutationItemRemove,
+    session: Session
+  ): Promise<T> {
+    const client = this.getClient(session);
+
+    // TODO: Consider whether we can skip this step by proxying the version as part of the CommercetoolsCartIdentifier
+    const existing = await client
+      .withId({ ID: payload.cart.key })
+      .get()
+      .execute();
+
+    const remote = await client
+      .withId({ ID: payload.cart.key })
+      .post({
+        body: {
+          version: existing.body.version,
+          actions: [
+            {
+              action: 'removeLineItem',
+              lineItemId: payload.item.key,
+            },
+          ],
+        },
+      })
+      .execute();
+
+    const result = this.composeCart(remote.body);
+
+    return result;
+  }
+
+  protected getClient(session: Session) {
+    const client = new CommercetoolsClient(this.config).getClient(
+      session.identity.token
+    );
+
+    const cartClient = client
+      .withProjectKey({ projectKey: this.config.projectKey })
+      .carts();
+
+    return cartClient;
+  }
+
+  protected composeCart(remote: CTCart): T {
+    const result = this.newModel();
+
+    result.identifier.key = remote.id;
+
+    for (const remoteItem of remote.lineItems) {
+      const item = CartItemSchema.parse({});
+
+      item.identifier.key = remoteItem.id;
+      item.product.key = remoteItem.productId;
+      item.quantity = remoteItem.quantity;
+
+      result.items.push(item);
+    }
+
+    return result;
+  }
+}