ACE SDK

The official JavaScript/TypeScript client for ACE (Agentic Commerce Engine). Use it in your Node.js apps, scripts, or serverless functions to enrich product feeds, generate content, and work with your ACE account programmatically.

• Product feed enrichment — Improve product data at scale
• Content generation — Descriptions, titles, and more
• Context & language — Rules and language detection for your catalog

New to ACE? Learn more at ace.authoritas.com and check the documentation for guides and API details.

Install

npm install @authoritas-ace/ace-sdk

Quick start

1. Get your API key from your ACE dashboard (or from your team admin).
2. Create a client with your ACE base URL and API key:

import { createClient } from "@authoritas-ace/ace-sdk";

const client = createClient({
  baseUrl: "https://ace.authoritas.com",  // or your ACE instance URL
  apiKey: process.env.ACE_API_KEY,
});

3. Call the API — for example, check your credit balance or enrich products:

// Check credit balance
const credits = await client.feed.credits();
if (credits.error) {
  console.error(credits.error.message);
} else {
  console.log("Balance:", credits.data?.balance);
}

// Enrich a list of products
const result = await client.feed.enrich({
  products: [
    { id: "1", title: "Blue Widget", description: "A widget." },
    // ...
  ],
});

What you can do

| Area | Methods | Use case | |-----------|---------|----------| | Feed | health(), credits(), enrich(body) | Check status, see balance, enrich product feeds | | Content | generate(body), bulk(body) | Generate descriptions, titles, or other content | | Context | rules(body) | Get contextual rules for your products | | Language | detect(body) | Detect language of product content | | Feeds | list(), get(id), delete(id) | List and manage feeds |

For full API details, request/response shapes, and examples, see the ACE documentation.

API key

Your API key is required for all operations except feed.health(). Pass it when creating the client:

createClient({
  baseUrl: "https://ace.authoritas.com",
  apiKey: "your-api-key-here",
});

Or use an environment variable (e.g. ACE_API_KEY) so you never commit secrets.

Handling errors

Each method returns { data?, error?, status }. Check error for failures:

const result = await client.feed.credits();
if (result.error) {
  console.error(result.error.code, result.error.message);
  return;
}
console.log(result.data?.balance);

For a throw-on-error style, use assertOk:

import { createClient, assertOk } from "@authoritas-ace/ace-sdk";

const client = createClient({ baseUrl: "...", apiKey: "..." });
const result = await client.feed.health();
assertOk(result);  // throws AceApiError if result.error is set
console.log(result.data.status);

Links

• ACE — Agentic Commerce Engine
• Documentation
• npm package

License

MIT