@interware/content-generator 0.7.2 → 0.8.1

package/dist/server/src/index.d.ts

@@ -1,5 +1,6 @@
 /// <reference types="node" />
 /// <reference types="node" />
+/// <reference types="node" />
 declare const _default: {
     register: ({ strapi }: {
         strapi: import("@strapi/types/dist/core").Strapi;
@@ -159,6 +160,136 @@ declare const _default: {
                 body: unknown;
             }) => Promise<void>;
         };
+        drive: ({ strapi }: {
+            strapi: import("@strapi/types/dist/core").Strapi;
+        }) => {
+            status: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+            saveClient: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+            removeClient: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+            authorizationUrl: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+            exchange: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+            disconnect: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+            links: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+            mark: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+            unmark: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+            syncNow: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+            browse: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+            count: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+            trash: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+            origin: (ctx: {
+                request: {
+                    body?: Record<string, unknown>;
+                };
+                query: Record<string, unknown>;
+                params?: Record<string, string>;
+                status: number;
+                body: unknown;
+            }) => Promise<void>;
+        };
         articles: ({ strapi }: {
             strapi: import("@strapi/types/dist/core").Strapi;
         }) => {
@@ -337,6 +468,60 @@ declare const _default: {
             renameFolder(from: unknown, to: unknown): Promise<string[]>;
             deleteFolder(path: unknown): Promise<string[]>;
         };
+        drive: ({ strapi }: {
+            strapi: import("@strapi/types/dist/core").Strapi;
+        }) => {
+            http: () => {
+                request: <T = unknown>(path: string, init?: RequestInit) => Promise<T>;
+                download: (path: string) => Promise<Uint8Array>;
+                about: () => Promise<import("./drive/client").DriveAbout>;
+                reset: () => any;
+            };
+            connected: () => Promise<boolean>;
+            runCycle: ({ full }?: {
+                full?: boolean;
+            }) => Promise<import("./drive/sync").SyncSummary>;
+            mark(cmsType: import("./drive/model").CmsType, cmsId: number): Promise<void>;
+            unmark(cmsType: import("./drive/model").CmsType, cmsId: number): Promise<void>;
+            syncNow(full?: boolean): Promise<import("./drive/sync").SyncSummary>;
+            track(cmsType: import("./drive/model").CmsType, cmsId: number): Promise<void>;
+            linkStatuses(): Promise<import("./services/drive").LinkStatuses>;
+            browse(folderId: unknown, pageToken?: unknown): Promise<{
+                path: {
+                    id: string;
+                    name: string;
+                }[];
+                items: {
+                    synced: boolean;
+                    id: string;
+                    name: string;
+                    mimeType: string;
+                    size: number;
+                    modifiedTime: string;
+                    webViewLink: string;
+                    parents: string[];
+                }[];
+                nextPageToken: string;
+            }>;
+            countItem(id: unknown): Promise<{
+                synced: boolean;
+                files: number;
+                folders: number;
+                truncated: boolean;
+            }>;
+            trashItem(id: unknown): Promise<void>;
+            setOrigin(fileId: unknown, documentId: unknown, name: unknown): Promise<void>;
+            saveClient(json: unknown, redirectUri: unknown): Promise<void>;
+            removeClient(): Promise<void>;
+            authorizationUrl(redirectUri: unknown): Promise<string>;
+            exchange({ code, state, redirectUri }: {
+                code?: unknown;
+                state?: unknown;
+                redirectUri?: unknown;
+            }): Promise<void>;
+            disconnect: () => Promise<void>;
+            status(): Promise<import("./services/drive").DriveStatus>;
+        };
         articles: ({ strapi }: {
             strapi: import("@strapi/types/dist/core").Strapi;
         }) => {
@@ -432,6 +617,115 @@ declare const _default: {
                 };
             };
         };
+        /**
+         * Plugin server methods
+         */
+        'drive-link': {
+            schema: {
+                kind: string;
+                collectionName: string;
+                info: {
+                    singularName: string;
+                    pluralName: string;
+                    displayName: string;
+                    description: string;
+                };
+                options: {
+                    draftAndPublish: boolean;
+                };
+                pluginOptions: {
+                    'content-manager': {
+                        visible: boolean;
+                    };
+                    'content-type-builder': {
+                        visible: boolean;
+                    };
+                };
+                attributes: {
+                    cmsType: {
+                        type: string;
+                        enum: string[];
+                        required: boolean;
+                    };
+                    cmsId: {
+                        type: string;
+                        required: boolean;
+                    };
+                    driveId: {
+                        type: string;
+                    };
+                    root: {
+                        type: string;
+                        default: boolean;
+                    };
+                    name: {
+                        type: string;
+                    };
+                    parentCmsId: {
+                        type: string;
+                    };
+                    version: {
+                        type: string;
+                    };
+                    driveRev: {
+                        type: string;
+                    };
+                    status: {
+                        type: string;
+                        enum: string[];
+                        default: string;
+                    };
+                    error: {
+                        type: string;
+                    };
+                };
+            };
+        };
+        'drive-op': {
+            schema: {
+                kind: string;
+                collectionName: string;
+                info: {
+                    singularName: string;
+                    pluralName: string;
+                    displayName: string;
+                    description: string;
+                };
+                options: {
+                    draftAndPublish: boolean;
+                };
+                pluginOptions: {
+                    'content-manager': {
+                        visible: boolean;
+                    };
+                    'content-type-builder': {
+                        visible: boolean;
+                    };
+                };
+                attributes: {
+                    cmsType: {
+                        type: string;
+                        enum: string[];
+                        required: boolean;
+                    };
+                    cmsId: {
+                        type: string;
+                        required: boolean;
+                    };
+                    attempts: {
+                        type: string;
+                        default: number;
+                    };
+                    runAfter: {
+                        type: string;
+                        default: string;
+                    };
+                    error: {
+                        type: string;
+                    };
+                };
+            };
+        };
     };
     policies: {};
     middlewares: {};

package/dist/server/src/services/drive.d.ts

@@ -0,0 +1,141 @@
+import type { Core } from '@strapi/strapi';
+import type { DriveAbout } from '../drive/client';
+import type { PublicDriveClient } from '../drive/clientConfig';
+import type { Cms, CmsType, CmsWriter, LinkRepo, LinkStatus, OpQueue } from '../drive/model';
+import type { Fetch, Store } from '../drive/oauth';
+import type { SyncSummary } from '../drive/sync';
+/** Refresh token y correo de la cuenta conectada. Nunca sale del servidor. */
+export declare const DRIVE_TOKEN_KEY = "DRIVE_TOKEN";
+/** Origen de los archivos exportados de un template: `{ [fileId]: { documentId, name } }` (S7.3). */
+export declare const DRIVE_ORIGINS_KEY = "DRIVE_ORIGINS";
+/** Entrada inválida (400) o conflicto (409) del panel. El mensaje es para mostrarse tal cual. */
+export declare class DriveInputError extends Error {
+    readonly status: 400 | 409;
+    constructor(message: string, status?: 400 | 409);
+}
+export interface LinkStatuses {
+    connected: boolean;
+    /** `inside`: el elemento se sincroniza (marcado o dentro de algo marcado); falso en ancestros que solo dan ruta. */
+    items: Record<string, {
+        status: LinkStatus;
+        root: boolean;
+        inside: boolean;
+        error: string | null;
+    }>;
+    lastRun: {
+        at: number;
+        processed: number;
+        errors: number;
+    } | null;
+    pending: number;
+}
+/** Puertos de la sincronización (S7.3); el `default` los arma con Strapi. */
+export interface SyncPorts {
+    cms: Cms;
+    links: LinkRepo;
+    ops: OpQueue;
+    /** Escrituras a la Biblioteca para lo que llega de Drive (S7.4). */
+    writer?: CmsWriter;
+    /** URL pública del CMS, para el link al template en la descripción de Drive. */
+    serverUrl: string;
+}
+export interface DriveConnection {
+    connected: boolean;
+    email: string | null;
+    usage: number | null;
+    limit: number | null;
+    error: string | null;
+}
+export interface DriveSyncState {
+    lastRun: {
+        at: number;
+        processed: number;
+        errors: number;
+    } | null;
+    pending: number;
+    /** Elementos con error u omitidos, con su motivo (máximo 20). */
+    errors: {
+        key: string;
+        name: string;
+        error: string;
+    }[];
+}
+export interface DriveStatus {
+    client: PublicDriveClient;
+    connection: DriveConnection;
+    sync: DriveSyncState | null;
+}
+/**
+ * Conexión con Google Drive (S7.1, ADR-008): cliente OAuth, autorización, canje, desconexión y estado. S7.2
+ * a S7.4 usan `http()` para hablar con Drive.
+ */
+export declare const createDriveService: ({ store, fetch: fetchFn, log, sync, }: {
+    store: Store;
+    fetch: Fetch;
+    log: Pick<Core.Strapi['log'], 'warn'> & Partial<Pick<Core.Strapi['log'], 'info'>>;
+    sync?: SyncPorts;
+}) => {
+    http: () => {
+        request: <T = unknown>(path: string, init?: RequestInit) => Promise<T>;
+        download: (path: string) => Promise<Uint8Array>;
+        about: () => Promise<DriveAbout>;
+        reset: () => any;
+    };
+    connected: () => Promise<boolean>;
+    runCycle: ({ full }?: {
+        full?: boolean;
+    }) => Promise<SyncSummary | null>;
+    /** Marca para sincronizar y programa el ciclo. */
+    mark(cmsType: CmsType, cmsId: number): Promise<void>;
+    unmark(cmsType: CmsType, cmsId: number): Promise<void>;
+    /** «Sincronizar ahora»; con `full`, «Revisión completa»: compara todo lo vinculado contra Drive. */
+    syncNow(full?: boolean): Promise<SyncSummary>;
+    /** Lifecycle de upload: encola si el elemento está (o estaba) en lo sincronizado. */
+    track(cmsType: CmsType, cmsId: number): Promise<void>;
+    linkStatuses(): Promise<LinkStatuses>;
+    /** Vista de Drive (S7.2): una carpeta en vivo con su ruta y qué hijos están sincronizados. */
+    browse(folderId: unknown, pageToken?: unknown): Promise<{
+        path: {
+            id: string;
+            name: string;
+        }[];
+        items: {
+            synced: boolean;
+            id: string;
+            name: string;
+            mimeType: string;
+            size: number;
+            modifiedTime: string;
+            webViewLink: string;
+            parents: string[];
+        }[];
+        nextPageToken: string;
+    }>;
+    /** Cuántos elementos se irían a la papelera con esta carpeta, y si está sincronizada. */
+    countItem(id: unknown): Promise<{
+        synced: boolean;
+        files: number;
+        folders: number;
+        truncated: boolean;
+    }>;
+    /** Eliminar desde la vista: a la papelera de Drive. Si estaba sincronizado, el siguiente ciclo lo borra del CMS. */
+    trashItem(id: unknown): Promise<void>;
+    /** El panel avisa que un archivo salió de un template (S7.3). */
+    setOrigin(fileId: unknown, documentId: unknown, name: unknown): Promise<void>;
+    /** Guarda el cliente del JSON de Google. Un cliente nuevo invalida la conexión anterior. */
+    saveClient(json: unknown, redirectUri: unknown): Promise<void>;
+    removeClient(): Promise<void>;
+    authorizationUrl(redirectUri: unknown): Promise<string>;
+    exchange({ code, state, redirectUri }: {
+        code?: unknown;
+        state?: unknown;
+        redirectUri?: unknown;
+    }): Promise<void>;
+    disconnect: () => Promise<void>;
+    status(): Promise<DriveStatus>;
+};
+export type DriveService = ReturnType<typeof createDriveService>;
+declare const _default: ({ strapi }: {
+    strapi: Core.Strapi;
+}) => DriveService;
+export default _default;

package/dist/server/src/services/index.d.ts

@@ -1,5 +1,6 @@
 /// <reference types="node" />
 /// <reference types="node" />
+/// <reference types="node" />
 declare const _default: {
     service: ({ strapi }: {
         strapi: import("@strapi/types/dist/core").Strapi;
@@ -63,6 +64,60 @@ declare const _default: {
         renameFolder(from: unknown, to: unknown): Promise<string[]>;
         deleteFolder(path: unknown): Promise<string[]>;
     };
+    drive: ({ strapi }: {
+        strapi: import("@strapi/types/dist/core").Strapi;
+    }) => {
+        http: () => {
+            request: <T = unknown>(path: string, init?: RequestInit) => Promise<T>;
+            download: (path: string) => Promise<Uint8Array>;
+            about: () => Promise<import("../drive/client").DriveAbout>;
+            reset: () => any;
+        };
+        connected: () => Promise<boolean>;
+        runCycle: ({ full }?: {
+            full?: boolean;
+        }) => Promise<import("../drive/sync").SyncSummary>;
+        mark(cmsType: import("../drive/model").CmsType, cmsId: number): Promise<void>;
+        unmark(cmsType: import("../drive/model").CmsType, cmsId: number): Promise<void>;
+        syncNow(full?: boolean): Promise<import("../drive/sync").SyncSummary>;
+        track(cmsType: import("../drive/model").CmsType, cmsId: number): Promise<void>;
+        linkStatuses(): Promise<import("./drive").LinkStatuses>;
+        browse(folderId: unknown, pageToken?: unknown): Promise<{
+            path: {
+                id: string;
+                name: string;
+            }[];
+            items: {
+                synced: boolean;
+                id: string;
+                name: string;
+                mimeType: string;
+                size: number;
+                modifiedTime: string;
+                webViewLink: string;
+                parents: string[];
+            }[];
+            nextPageToken: string;
+        }>;
+        countItem(id: unknown): Promise<{
+            synced: boolean;
+            files: number;
+            folders: number;
+            truncated: boolean;
+        }>;
+        trashItem(id: unknown): Promise<void>;
+        setOrigin(fileId: unknown, documentId: unknown, name: unknown): Promise<void>;
+        saveClient(json: unknown, redirectUri: unknown): Promise<void>;
+        removeClient(): Promise<void>;
+        authorizationUrl(redirectUri: unknown): Promise<string>;
+        exchange({ code, state, redirectUri }: {
+            code?: unknown;
+            state?: unknown;
+            redirectUri?: unknown;
+        }): Promise<void>;
+        disconnect: () => Promise<void>;
+        status(): Promise<import("./drive").DriveStatus>;
+    };
     articles: ({ strapi }: {
         strapi: import("@strapi/types/dist/core").Strapi;
     }) => {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.7.2",
+  "version": "0.8.1",
   "keywords": [],
   "type": "commonjs",
   "publishConfig": {