3y3anaa SDKs

3y3anaa exposes its App Reviews platform through one published package:

`@duabalabs/reviews-sdk`

A framework-agnostic, server-side client for the centralized 3y3anaa reviews platform — the shared review/rating store every Duaba app plugs into.

Framework-agnostic — no React/Next coupling; works in any Node server, edge runtime, or browser (with care).
Server-side — authenticates with a secret per-app key (X-App-Key); call it from your server, never a browser bundle.
Fetch-based — a thin wrapper over POST /<serverUrl>/functions/<fn>; supply your own fetch for old Node.
Dual format — ships ESM + CJS with .d.ts types (built with tsup).

Install, createReviewsClient config, every method, types, errors, and the Sellub worked example.

reviews-sdk reference

Install

npm i @duabalabs/reviews-sdk
# or
pnpm add @duabalabs/reviews-sdk

Who uses it

App	Subjects	Notes
Sellub (today)	`product`, `shop`, `supplier`, `courier`	Verified-purchase product reviews + shop reviews on the storefront.
Future Duaba apps	any scoped subject	Onboard with their own `AppCredential` + scopes.

The SDK exposes only the App Reviews platform functions (submitAppReview, getAppReviews, aggregates, helpful, respond, by-author). The BBB internals (Trust Score engine, moderation, claims) are not part of the SDK surface — they’re driven by the 3y3anaa app and admin tooling.

Configuration & env

Env var	Header	Purpose
`THREEYANAA_API_URL`	—	Parse server base, e.g. `https://api.3y3anaa.com/parse`.
`THREEYANAA_PARSE_APP_ID`	`X-Parse-Application-Id`	Parse Application Id.
`THREEYANAA_PARSE_JS_KEY`	`X-Parse-Javascript-Key`	Parse JS key (required by the server; not secret).
`THREEYANAA_APP_KEY`	`X-App-Key`	Secret per-app credential. Keep server-side.

Provision the app key on the 3y3anaa server with provisionAppCredential — it’s shown once. See the full reference.

For Businesses reviews-sdk