@totoday/quinn-sdk 0.1.0

package/dist/http.d.ts

@@ -0,0 +1,6 @@
+import { AxiosInstance } from 'axios';
+export interface QuinnHttpConfig {
+    apiUrl: string;
+    token: string;
+}
+export declare function createQuinnHttpClient(config: QuinnHttpConfig): AxiosInstance;

package/dist/http.js

@@ -0,0 +1,16 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createQuinnHttpClient = createQuinnHttpClient;
+const axios_1 = __importDefault(require("axios"));
+function createQuinnHttpClient(config) {
+    return axios_1.default.create({
+        baseURL: config.apiUrl,
+        headers: {
+            Authorization: `Bearer ${config.token}`,
+            'Content-Type': 'application/json',
+        },
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import { AxiosInstance } from 'axios';
+import { CompetenciesService } from './services/competencies';
+import { EndorsementsService } from './services/endorsements';
+import { LevelsService } from './services/levels';
+import { MembersService } from './services/members';
+import { OrganizationsService } from './services/organizations';
+import { RolesService } from './services/roles';
+export * from './types';
+export interface QuinnClientConfig {
+    apiUrl: string;
+    token: string;
+    orgId: string;
+    httpClient?: AxiosInstance;
+}
+export declare class Quinn {
+    private readonly config;
+    private readonly http;
+    readonly organizations: OrganizationsService;
+    readonly members: MembersService;
+    readonly roles: RolesService;
+    readonly levels: LevelsService;
+    readonly competencies: CompetenciesService;
+    readonly endorsements: EndorsementsService;
+    constructor(config: QuinnClientConfig);
+    private orgPath;
+}

package/dist/index.js

@@ -0,0 +1,49 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Quinn = void 0;
+const http_1 = require("./http");
+const competencies_1 = require("./services/competencies");
+const endorsements_1 = require("./services/endorsements");
+const levels_1 = require("./services/levels");
+const members_1 = require("./services/members");
+const organizations_1 = require("./services/organizations");
+const roles_1 = require("./services/roles");
+__exportStar(require("./types"), exports);
+class Quinn {
+    config;
+    http;
+    organizations;
+    members;
+    roles;
+    levels;
+    competencies;
+    endorsements;
+    constructor(config) {
+        this.config = config;
+        this.http =
+            config.httpClient ??
+                (0, http_1.createQuinnHttpClient)({ apiUrl: config.apiUrl, token: config.token });
+        this.organizations = new organizations_1.OrganizationsService(this.http, this.orgPath);
+        this.members = new members_1.MembersService(this.http, this.orgPath);
+        this.roles = new roles_1.RolesService(this.http, this.orgPath);
+        this.levels = new levels_1.LevelsService(this.http, this.orgPath);
+        this.competencies = new competencies_1.CompetenciesService(this.http, this.orgPath);
+        this.endorsements = new endorsements_1.EndorsementsService(this.http, this.orgPath);
+    }
+    orgPath = () => `/platform/v1/orgs/${this.config.orgId}`;
+}
+exports.Quinn = Quinn;

package/dist/services/competencies.d.ts

@@ -0,0 +1,11 @@
+import { AxiosInstance } from 'axios';
+import { CompetenciesListQuery, Competency, Course, PagedResult } from '../types';
+export declare class CompetenciesService {
+    private readonly http;
+    private readonly orgPath;
+    constructor(http: AxiosInstance, orgPath: () => string);
+    list(query: CompetenciesListQuery): Promise<PagedResult<Competency>>;
+    get(id: string): Promise<Competency | null>;
+    batchGet(ids: string[]): Promise<Competency[]>;
+    listCourses(id: string): Promise<Course[]>;
+}

package/dist/services/competencies.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompetenciesService = void 0;
+class CompetenciesService {
+    http;
+    orgPath;
+    constructor(http, orgPath) {
+        this.http = http;
+        this.orgPath = orgPath;
+    }
+    async list(query) {
+        const resp = await this.http.get(`${this.orgPath()}/competencies`, { params: query });
+        return resp.data;
+    }
+    async get(id) {
+        const resp = await this.http.get(`${this.orgPath()}/competencies/${id}`);
+        return resp.data.item;
+    }
+    async batchGet(ids) {
+        const resp = await this.http.post(`${this.orgPath()}/competencies/batch`, { ids });
+        return resp.data.items;
+    }
+    async listCourses(id) {
+        const resp = await this.http.get(`${this.orgPath()}/competencies/${id}/courses`);
+        return resp.data.items;
+    }
+}
+exports.CompetenciesService = CompetenciesService;

package/dist/services/endorsements.d.ts

@@ -0,0 +1,10 @@
+import { AxiosInstance } from 'axios';
+import { Endorsement, ListEndorsementsInput } from '../types';
+export declare class EndorsementsService {
+    private readonly http;
+    private readonly orgPath;
+    constructor(http: AxiosInstance, orgPath: () => string);
+    get(id: string): Promise<Endorsement | null>;
+    find(uid: string, competencyId: string): Promise<Endorsement | null>;
+    list(input: ListEndorsementsInput): Promise<Endorsement[]>;
+}

package/dist/services/endorsements.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EndorsementsService = void 0;
+class EndorsementsService {
+    http;
+    orgPath;
+    constructor(http, orgPath) {
+        this.http = http;
+        this.orgPath = orgPath;
+    }
+    async get(id) {
+        const resp = await this.http.get(`${this.orgPath()}/endorsements/${id}`);
+        return resp.data.item;
+    }
+    async find(uid, competencyId) {
+        const resp = await this.http.get(`${this.orgPath()}/endorsements/find`, { params: { uid, competencyId } });
+        return resp.data.item;
+    }
+    async list(input) {
+        const resp = await this.http.post(`${this.orgPath()}/endorsements/list`, input);
+        return resp.data.items;
+    }
+}
+exports.EndorsementsService = EndorsementsService;

package/dist/services/levels.d.ts

@@ -0,0 +1,10 @@
+import { AxiosInstance } from 'axios';
+import { Level, LevelsListQuery, PagedResult } from '../types';
+export declare class LevelsService {
+    private readonly http;
+    private readonly orgPath;
+    constructor(http: AxiosInstance, orgPath: () => string);
+    list(query: LevelsListQuery): Promise<PagedResult<Level>>;
+    get(id: string): Promise<Level | null>;
+    batchGet(ids: string[]): Promise<Level[]>;
+}

package/dist/services/levels.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LevelsService = void 0;
+class LevelsService {
+    http;
+    orgPath;
+    constructor(http, orgPath) {
+        this.http = http;
+        this.orgPath = orgPath;
+    }
+    async list(query) {
+        const resp = await this.http.get(`${this.orgPath()}/levels`, {
+            params: query,
+        });
+        return resp.data;
+    }
+    async get(id) {
+        const resp = await this.http.get(`${this.orgPath()}/levels/${id}`);
+        return resp.data.item;
+    }
+    async batchGet(ids) {
+        const resp = await this.http.post(`${this.orgPath()}/levels/batch`, { ids });
+        return resp.data.items;
+    }
+}
+exports.LevelsService = LevelsService;

package/dist/services/members.d.ts

@@ -0,0 +1,15 @@
+import { AxiosInstance } from 'axios';
+import { Member, MembersBatchGetInput, MembersListQuery, PagedResult } from '../types';
+export declare class MembersService {
+    private readonly http;
+    private readonly orgPath;
+    constructor(http: AxiosInstance, orgPath: () => string);
+    list(query?: MembersListQuery): Promise<PagedResult<Member>>;
+    listManagers(query?: {
+        limit?: number;
+        token?: string;
+        search?: string;
+    }): Promise<PagedResult<Member>>;
+    get(id: string): Promise<Member | null>;
+    batchGet(input: string[] | MembersBatchGetInput): Promise<Member[]>;
+}

package/dist/services/members.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MembersService = void 0;
+class MembersService {
+    http;
+    orgPath;
+    constructor(http, orgPath) {
+        this.http = http;
+        this.orgPath = orgPath;
+    }
+    async list(query = {}) {
+        const params = {
+            limit: query.limit,
+            token: query.token,
+            search: query.search,
+            managerUid: query.managerUid,
+            privilege: Array.isArray(query.privilege)
+                ? query.privilege.join(',')
+                : query.privilege,
+        };
+        const resp = await this.http.get(`${this.orgPath()}/members`, { params });
+        return resp.data;
+    }
+    async listManagers(query = {}) {
+        const resp = await this.http.get(`${this.orgPath()}/members/managers`, { params: query });
+        return resp.data;
+    }
+    async get(id) {
+        const resp = await this.http.get(`${this.orgPath()}/members/${id}`);
+        return resp.data.item;
+    }
+    async batchGet(input) {
+        const body = Array.isArray(input)
+            ? { ids: input }
+            : input;
+        const resp = await this.http.post(`${this.orgPath()}/members/batch`, body);
+        return resp.data.items;
+    }
+}
+exports.MembersService = MembersService;

package/dist/services/organizations.d.ts

@@ -0,0 +1,9 @@
+import { AxiosInstance } from 'axios';
+import { Organization, OrganizationDetails } from '../types';
+export declare class OrganizationsService {
+    private readonly http;
+    private readonly orgPath;
+    constructor(http: AxiosInstance, orgPath: () => string);
+    get(): Promise<Organization | null>;
+    getDetails(): Promise<OrganizationDetails>;
+}

package/dist/services/organizations.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrganizationsService = void 0;
+class OrganizationsService {
+    http;
+    orgPath;
+    constructor(http, orgPath) {
+        this.http = http;
+        this.orgPath = orgPath;
+    }
+    async get() {
+        const resp = await this.http.get(this.orgPath());
+        return resp.data.item;
+    }
+    async getDetails() {
+        const resp = await this.http.get(`${this.orgPath()}/details`);
+        return resp.data.item;
+    }
+}
+exports.OrganizationsService = OrganizationsService;

package/dist/services/roles.d.ts

@@ -0,0 +1,10 @@
+import { AxiosInstance } from 'axios';
+import { Role } from '../types';
+export declare class RolesService {
+    private readonly http;
+    private readonly orgPath;
+    constructor(http: AxiosInstance, orgPath: () => string);
+    list(): Promise<Role[]>;
+    get(id: string): Promise<Role | null>;
+    batchGet(ids: string[]): Promise<Role[]>;
+}

package/dist/services/roles.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RolesService = void 0;
+class RolesService {
+    http;
+    orgPath;
+    constructor(http, orgPath) {
+        this.http = http;
+        this.orgPath = orgPath;
+    }
+    async list() {
+        const resp = await this.http.get(`${this.orgPath()}/roles`);
+        return resp.data.items;
+    }
+    async get(id) {
+        const resp = await this.http.get(`${this.orgPath()}/roles/${id}`);
+        return resp.data.item;
+    }
+    async batchGet(ids) {
+        const resp = await this.http.post(`${this.orgPath()}/roles/batch`, { ids });
+        return resp.data.items;
+    }
+}
+exports.RolesService = RolesService;

package/dist/types.d.ts

@@ -0,0 +1,107 @@
+export type Privilege = 'owner' | 'admin' | 'member';
+export interface PaginationQuery {
+    limit?: number;
+    token?: string;
+}
+export interface PagedResult<T> {
+    items: T[];
+    nextToken: string;
+}
+export interface Organization {
+    id: string;
+    name: string;
+}
+export interface OrganizationDetails {
+    organization: Organization | null;
+    stats: {
+        members: number;
+        managers: number;
+        roles: number;
+        levels: number;
+        competencies: number;
+    };
+}
+export interface Member {
+    userId: string;
+    email: string;
+    firstName: string;
+    lastName: string;
+    privilege: Privilege;
+    managerUid: string | null;
+    roleIds: string[];
+    createdAt: string;
+    activatedAt: string | null;
+    phoneNumber: string | null;
+}
+export interface MembersListQuery extends PaginationQuery {
+    search?: string;
+    privilege?: Privilege | Privilege[];
+    managerUid?: string;
+}
+export interface MembersBatchGetInput {
+    ids?: string[];
+    emails?: string[];
+}
+export interface Role {
+    id: string;
+    label: string;
+    levelIds: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Level {
+    id: string;
+    roleId: string;
+    name: string;
+    color: string;
+    value: number;
+    completeThreshold: number;
+    revenueCapacity: number | null;
+    compensation: string | null;
+    competencyIds: string[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface LevelsListQuery extends PaginationQuery {
+    roleId: string;
+}
+export interface Competency {
+    id: string;
+    name: string;
+    creatorUid: string;
+    createdAt: string;
+    settings?: {
+        managerOnlyEndorsement: boolean;
+    };
+}
+export interface CompetenciesListQuery extends PaginationQuery {
+    roleId: string;
+    levelId: string;
+    search?: string;
+}
+export interface Course {
+    id: string;
+    name: string;
+    creatorUid: string;
+    createdAt: string;
+}
+export interface Endorsement {
+    id: string;
+    uid: string;
+    competencyId: string;
+    roleId: string | null;
+    selfAssessment: string | null;
+    selfAssessedAt: string | null;
+    endorsedAt: string | null;
+    endorsedByUid: string | null;
+    endorsementSource: string | null;
+    resetAt: string | null;
+    resetByUid: string | null;
+    resetReason: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface ListEndorsementsInput {
+    uids: string[];
+    competencyIds: string[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@totoday/quinn-sdk",
+  "version": "0.1.0",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "axios": "^1.8.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.2"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist"
+  }
+}