crewly 1.20.29 → 1.20.31

package/dist/backend/backend/src/services/canva/canva-token.service.d.ts

@@ -0,0 +1,98 @@
+/**
+ * CanvaTokenService — the Canva access token for this instance, minted by
+ * Crewly Cloud from the owner's grant (`/api/cloud/canva/token`).
+ *
+ * Mirrors GoogleWorkspaceTokenService: Cloud keeps the client secret and the
+ * (single-use, rotating) refresh token; this side caches the access token
+ * until a minute before expiry and shares one in-flight refresh.
+ *
+ * @module services/canva/canva-token.service
+ */
+/** The slice of the Cloud client the service needs (injectable for tests). */
+export interface CanvaCloudClient {
+    isConnected(): boolean;
+    getToken(): string | null;
+    getCloudUrl(): string | null;
+}
+/** Constructor dependencies. */
+export interface CanvaTokenServiceDeps {
+    cloud?: CanvaCloudClient;
+    fetchImpl?: typeof fetch;
+    now?: () => number;
+}
+/** `GET /api/canva/status` payload. */
+export interface CanvaStatus {
+    connected: boolean;
+    cloudConnected: boolean;
+    canvaUserId?: string;
+    canvaTeamId?: string;
+    displayName?: string;
+    scopes?: string[];
+    grantedAt?: string;
+}
+/** A Canva failure with the HTTP status the controller answers with. */
+export declare class CanvaError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+/**
+ * Map a Cloud grant-endpoint failure onto this instance's error codes.
+ *
+ * @param httpStatus - Cloud HTTP status
+ * @param code - Cloud `error` / `code`
+ * @param message - Cloud message
+ * @returns The mapped error
+ */
+export declare function mapCloudFailure(httpStatus: number, code: string | undefined, message: string | undefined): CanvaError;
+/**
+ * Access-token provider for the Canva API.
+ */
+export declare class CanvaTokenService {
+    private static instance;
+    private readonly logger;
+    private readonly cloud;
+    private readonly fetchImpl;
+    private readonly nowFn;
+    private cached;
+    private inflight;
+    constructor(deps?: CanvaTokenServiceDeps);
+    static getInstance(): CanvaTokenService;
+    static resetInstance(): void;
+    isCloudAvailable(): boolean;
+    /**
+     * A usable access token (cached until 60 s before expiry).
+     *
+     * @returns The token
+     * @throws CanvaError not_logged_in / not_connected / not_configured / canva_error / network
+     */
+    getAccessToken(): Promise<string>;
+    /** Forget the cached token (after a Canva 401 or a disconnect). */
+    clearCache(): void;
+    /**
+     * Whether Cloud holds a Canva grant; "not there" cases come back as
+     * `connected: false`, outages throw.
+     *
+     * @returns Status
+     */
+    status(): Promise<CanvaStatus>;
+    /**
+     * Ask Cloud to revoke and forget the grant.
+     *
+     * @returns Whether Cloud had one
+     */
+    disconnect(): Promise<{
+        removed: boolean;
+    }>;
+    /**
+     * The Cloud consent-start URL for the browser.
+     *
+     * @param returnUrl - Absolute dashboard URL Cloud redirects back to
+     * @returns URL to open
+     * @throws CanvaError(401, not_logged_in) when not signed in to Cloud
+     */
+    buildConnectUrl(returnUrl: string): string;
+    private refresh;
+    private cloudRequest;
+}
+//# sourceMappingURL=canva-token.service.d.ts.map

package/dist/backend/backend/src/services/canva/canva-token.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canva-token.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/canva/canva-token.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,WAAW,IAAI,OAAO,CAAC;IACvB,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAC;IAC1B,WAAW,IAAI,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,gCAAgC;AAChC,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoBD,wEAAwE;AACxE,qBAAa,UAAW,SAAQ,KAAK;aAEjB,MAAM,EAAE,MAAM;aACd,IAAI,EAAE,MAAM;gBADZ,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAerH;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAmB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,MAAM,CAA6D;IAC3E,OAAO,CAAC,QAAQ,CAAgC;gBAEpC,IAAI,GAAE,qBAA0B;IAO5C,MAAM,CAAC,WAAW,IAAI,iBAAiB;IAKvC,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B,gBAAgB,IAAI,OAAO;IAI3B;;;;;OAKG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IASvC,mEAAmE;IACnE,UAAU,IAAI,IAAI;IAIlB;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAuBpC;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAMjD;;;;;;OAMG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;YAY5B,OAAO;YAcP,YAAY;CAuB3B"}

package/dist/backend/backend/src/services/canva/canva-token.service.js

@@ -0,0 +1,198 @@
+/**
+ * CanvaTokenService — the Canva access token for this instance, minted by
+ * Crewly Cloud from the owner's grant (`/api/cloud/canva/token`).
+ *
+ * Mirrors GoogleWorkspaceTokenService: Cloud keeps the client secret and the
+ * (single-use, rotating) refresh token; this side caches the access token
+ * until a minute before expiry and shares one in-flight refresh.
+ *
+ * @module services/canva/canva-token.service
+ */
+import { CloudClientService } from '../cloud/cloud-client.service.js';
+import { LoggerService } from '../core/logger.service.js';
+import { CANVA_CONSTANTS } from '../../constants.js';
+/** A Canva failure with the HTTP status the controller answers with. */
+export class CanvaError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = 'CanvaError';
+    }
+}
+/**
+ * Map a Cloud grant-endpoint failure onto this instance's error codes.
+ *
+ * @param httpStatus - Cloud HTTP status
+ * @param code - Cloud `error` / `code`
+ * @param message - Cloud message
+ * @returns The mapped error
+ */
+export function mapCloudFailure(httpStatus, code, message) {
+    const CODES = CANVA_CONSTANTS.ERROR_CODES;
+    if (httpStatus === 401 || httpStatus === 403) {
+        return new CanvaError(401, CODES.NOT_LOGGED_IN, 'Crewly Cloud session expired. Sign in to Crewly Cloud again.');
+    }
+    if (httpStatus === 404 || httpStatus === 409 || code === CODES.NOT_CONNECTED || code === 'grant_revoked') {
+        return new CanvaError(409, CODES.NOT_CONNECTED, 'Canva is not connected for this Crewly Cloud account.');
+    }
+    if (httpStatus === 503 || code === CODES.NOT_CONFIGURED) {
+        return new CanvaError(503, CODES.NOT_CONFIGURED, 'Crewly Cloud is not configured for Canva.');
+    }
+    if (httpStatus === 502 || code === CODES.CANVA_ERROR) {
+        return new CanvaError(502, CODES.CANVA_ERROR, message || 'Canva rejected the token request.');
+    }
+    return new CanvaError(502, code ?? `http_${httpStatus}`, message || `Cloud request failed (${httpStatus})`);
+}
+/**
+ * Access-token provider for the Canva API.
+ */
+export class CanvaTokenService {
+    static instance = null;
+    logger;
+    cloud;
+    fetchImpl;
+    nowFn;
+    cached = null;
+    inflight = null;
+    constructor(deps = {}) {
+        this.logger = LoggerService.getInstance().createComponentLogger('CanvaToken');
+        this.cloud = deps.cloud ?? CloudClientService.getInstance();
+        this.fetchImpl = deps.fetchImpl ?? fetch;
+        this.nowFn = deps.now ?? (() => Date.now());
+    }
+    static getInstance() {
+        if (!CanvaTokenService.instance)
+            CanvaTokenService.instance = new CanvaTokenService();
+        return CanvaTokenService.instance;
+    }
+    static resetInstance() {
+        CanvaTokenService.instance = null;
+    }
+    isCloudAvailable() {
+        return this.cloud.isConnected() && !!this.cloud.getToken() && !!this.cloud.getCloudUrl();
+    }
+    /**
+     * A usable access token (cached until 60 s before expiry).
+     *
+     * @returns The token
+     * @throws CanvaError not_logged_in / not_connected / not_configured / canva_error / network
+     */
+    async getAccessToken() {
+        if (this.cached && this.cached.expiresAtMs - CANVA_CONSTANTS.TOKEN_REFRESH_MARGIN_MS > this.nowFn())
+            return this.cached.accessToken;
+        if (this.inflight)
+            return this.inflight;
+        this.inflight = this.refresh().finally(() => {
+            this.inflight = null;
+        });
+        return this.inflight;
+    }
+    /** Forget the cached token (after a Canva 401 or a disconnect). */
+    clearCache() {
+        this.cached = null;
+    }
+    /**
+     * Whether Cloud holds a Canva grant; "not there" cases come back as
+     * `connected: false`, outages throw.
+     *
+     * @returns Status
+     */
+    async status() {
+        if (!this.isCloudAvailable())
+            return { connected: false, cloudConnected: false };
+        try {
+            const data = await this.cloudRequest('GET', CANVA_CONSTANTS.CLOUD_ENDPOINTS.STATUS);
+            if (!data.connected)
+                this.clearCache();
+            return {
+                connected: !!data.connected,
+                cloudConnected: true,
+                ...(data.canvaUserId ? { canvaUserId: data.canvaUserId } : {}),
+                ...(data.canvaTeamId ? { canvaTeamId: data.canvaTeamId } : {}),
+                ...(data.displayName ? { displayName: data.displayName } : {}),
+                ...(data.scopes ? { scopes: data.scopes } : {}),
+                ...(data.grantedAt ? { grantedAt: data.grantedAt } : {}),
+            };
+        }
+        catch (err) {
+            if (err instanceof CanvaError && err.code === CANVA_CONSTANTS.ERROR_CODES.NOT_CONNECTED) {
+                this.clearCache();
+                return { connected: false, cloudConnected: true };
+            }
+            throw err;
+        }
+    }
+    /**
+     * Ask Cloud to revoke and forget the grant.
+     *
+     * @returns Whether Cloud had one
+     */
+    async disconnect() {
+        this.clearCache();
+        const data = await this.cloudRequest('DELETE', CANVA_CONSTANTS.CLOUD_ENDPOINTS.DISCONNECT);
+        return { removed: !!data.removed };
+    }
+    /**
+     * The Cloud consent-start URL for the browser.
+     *
+     * @param returnUrl - Absolute dashboard URL Cloud redirects back to
+     * @returns URL to open
+     * @throws CanvaError(401, not_logged_in) when not signed in to Cloud
+     */
+    buildConnectUrl(returnUrl) {
+        const token = this.cloud.getToken();
+        const base = this.cloud.getCloudUrl();
+        if (!this.isCloudAvailable() || !token || !base) {
+            throw new CanvaError(401, CANVA_CONSTANTS.ERROR_CODES.NOT_LOGGED_IN, 'Sign in to Crewly Cloud first.');
+        }
+        const url = new URL(`${base.replace(/\/$/, '')}${CANVA_CONSTANTS.CLOUD_PATH}${CANVA_CONSTANTS.CLOUD_ENDPOINTS.START}`);
+        url.searchParams.set('token', token);
+        url.searchParams.set('returnUrl', returnUrl);
+        return url.toString();
+    }
+    async refresh() {
+        try {
+            const data = await this.cloudRequest('GET', CANVA_CONSTANTS.CLOUD_ENDPOINTS.TOKEN);
+            if (!data.accessToken)
+                throw new CanvaError(502, CANVA_CONSTANTS.ERROR_CODES.CANVA_ERROR, 'Cloud returned no access token.');
+            const expiresAtMs = Date.parse(data.expiresAt);
+            this.cached = { accessToken: data.accessToken, expiresAtMs: Number.isFinite(expiresAtMs) ? expiresAtMs : this.nowFn() };
+            this.logger.debug('Canva access token refreshed', { expiresAt: data.expiresAt });
+            return data.accessToken;
+        }
+        catch (err) {
+            this.cached = null;
+            throw err;
+        }
+    }
+    async cloudRequest(method, suffix) {
+        const token = this.cloud.getToken();
+        const base = this.cloud.getCloudUrl();
+        if (!this.isCloudAvailable() || !token || !base) {
+            throw new CanvaError(401, CANVA_CONSTANTS.ERROR_CODES.NOT_LOGGED_IN, 'Not signed in to Crewly Cloud.');
+        }
+        const url = `${base.replace(/\/$/, '')}${CANVA_CONSTANTS.CLOUD_PATH}${suffix}`;
+        let res;
+        try {
+            res = await this.fetchImpl(url, { method, headers: { Authorization: `Bearer ${token}` }, signal: AbortSignal.timeout(CANVA_CONSTANTS.REQUEST_TIMEOUT_MS) });
+        }
+        catch (err) {
+            throw new CanvaError(502, CANVA_CONSTANTS.ERROR_CODES.NETWORK, `Crewly Cloud unreachable: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        const text = await res.text();
+        let parsed = {};
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            parsed = {};
+        }
+        if (!res.ok || parsed.success !== true)
+            throw mapCloudFailure(res.status, parsed.code ?? parsed.error, parsed.error);
+        return (parsed.data ?? {});
+    }
+}
+//# sourceMappingURL=canva-token.service.js.map

package/dist/backend/backend/src/services/canva/canva-token.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canva-token.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/canva/canva-token.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/canva/canva.service.d.ts

@@ -0,0 +1,184 @@
+/**
+ * CanvaService — Canva Connect REST on the owner's grant.
+ *
+ * What agents can do: find designs, create a blank design (preset type or
+ * custom size, optionally from an uploaded asset), export a design
+ * (PDF / PNG / JPG / PPTX / GIF / MP4 — an async job, polled here to a
+ * download URL), and upload images / videos as assets. Video *generation*
+ * is not in the API: agents fill, duplicate and export, they do not render
+ * from scratch. Brand templates need Canva Enterprise and are not wired.
+ *
+ * @module services/canva/canva.service
+ */
+/** Token provider slice. */
+export interface CanvaTokenProvider {
+    getAccessToken(): Promise<string>;
+    clearCache(): void;
+}
+/** Service dependencies. */
+export interface CanvaApiDeps {
+    tokens: CanvaTokenProvider;
+    fetchImpl?: typeof fetch;
+    /** Sleep between job polls (injectable for tests). */
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+}
+/** A design, trimmed. */
+export interface CanvaDesign {
+    id: string;
+    title: string;
+    editUrl?: string;
+    viewUrl?: string;
+    thumbnailUrl?: string;
+    pageCount?: number;
+    createdAt?: string;
+    updatedAt?: string;
+}
+/** List input. */
+export interface CanvaListInput {
+    query?: string;
+    ownership?: 'any' | 'owned' | 'shared';
+    sortBy?: 'relevance' | 'modified_descending' | 'modified_ascending' | 'title_descending' | 'title_ascending';
+    limit?: number;
+    continuation?: string;
+}
+/** Create input. */
+export interface CanvaCreateInput {
+    title?: string;
+    /** `doc` | `whiteboard` | `presentation` */
+    preset?: string;
+    /** Custom size in px (40–8000) */
+    width?: number;
+    height?: number;
+    /** Start from an uploaded asset (image) */
+    assetId?: string;
+}
+/** Export input. */
+export interface CanvaExportInput {
+    designId: string;
+    format: string;
+    /** JPG quality 1–100 (default 80) */
+    quality?: number;
+    /** MP4 quality preset, e.g. `horizontal_1080p` (default) */
+    videoQuality?: string;
+    /** Page numbers (1-based) */
+    pages?: number[];
+}
+/** Export result. */
+export interface CanvaExport {
+    jobId: string;
+    status: 'success' | 'failed' | 'in_progress';
+    /** Download URLs (short-lived), one per file */
+    urls: string[];
+    error?: {
+        code?: string;
+        message?: string;
+    };
+}
+/** An uploaded asset. */
+export interface CanvaAsset {
+    id: string;
+    name: string;
+    thumbnailUrl?: string;
+    createdAt?: string;
+}
+interface WireDesign {
+    id?: string;
+    title?: string;
+    urls?: {
+        edit_url?: string;
+        view_url?: string;
+    };
+    thumbnail?: {
+        url?: string;
+    };
+    page_count?: number;
+    created_at?: number;
+    updated_at?: number;
+}
+/**
+ * Trim a Canva design resource.
+ *
+ * @param d - Wire design
+ * @returns Trimmed
+ */
+export declare function toDesign(d: WireDesign): CanvaDesign;
+/**
+ * The `format` object for an export job.
+ *
+ * @param input - Export input
+ * @returns Canva format object
+ * @throws CanvaError(400, validation) for an unknown format / bad quality
+ */
+export declare function buildExportFormat(input: CanvaExportInput): Record<string, unknown>;
+/**
+ * Canva Connect calls.
+ */
+export declare class CanvaService {
+    private readonly deps;
+    private readonly base;
+    /**
+     * @param deps - Token provider, fetch, sleep
+     */
+    constructor(deps: CanvaApiDeps);
+    /**
+     * `GET /designs` — search / list.
+     *
+     * @param input - Query, ownership, sort, limit, continuation
+     * @returns Designs + continuation token
+     */
+    listDesigns(input?: CanvaListInput): Promise<{
+        designs: CanvaDesign[];
+        continuation?: string;
+    }>;
+    /**
+     * `GET /designs/:id`.
+     *
+     * @param id - Design id
+     * @returns The design
+     */
+    getDesign(id: string): Promise<CanvaDesign>;
+    /**
+     * `POST /designs` — a new design from a preset type, a custom size, or an asset.
+     *
+     * @param input - Title + type/size/asset
+     * @returns The new design (with editUrl)
+     * @throws CanvaError(400, validation) when neither a valid preset, size nor asset is given
+     */
+    createDesign(input: CanvaCreateInput): Promise<CanvaDesign>;
+    /**
+     * `POST /exports` then poll `GET /exports/:id` until done.
+     *
+     * @param input - Design, format, options
+     * @returns Download URLs (or the failure)
+     */
+    exportDesign(input: CanvaExportInput): Promise<CanvaExport>;
+    /**
+     * `POST /asset-uploads` (binary body) then poll `GET /asset-uploads/:id`.
+     *
+     * @param name - Asset name (≤ 50 chars)
+     * @param bytes - File content
+     * @returns The asset
+     * @throws CanvaError(400, validation) for an empty/oversized file; 502 when the job fails
+     */
+    uploadAsset(name: string, bytes: Buffer): Promise<CanvaAsset>;
+    /**
+     * Poll a job until it leaves `in_progress` or the ceiling passes.
+     *
+     * @param url - Job URL
+     * @param first - The job as returned by the create call
+     * @returns The final job
+     */
+    private pollJob;
+    /**
+     * Authenticated call; 401 drops the cached token, 403/404/429 pass
+     * through, other failures fold into 502.
+     *
+     * @param url - Absolute URL
+     * @param init - Method / body / headers
+     * @returns Parsed JSON
+     */
+    private request;
+}
+export {};
+//# sourceMappingURL=canva.service.d.ts.map

package/dist/backend/backend/src/services/canva/canva.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canva.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/canva/canva.service.ts"],"names":[],"mappings":"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"}