@aurabase/functions 0.6.0 → 0.6.2

package/dist/index.cjs

@@ -265,6 +265,10 @@ var FunctionsService = class extends core.BaseService {
     }
   }
   // -- Function CRUD ----------------------------------------------------------
+  /**
+   * Liste les fonctions déployées du projet, avec leur code source et leurs variables.
+   * Exige une clé `service_role` : une clé publique reçoit `403`.
+   */
   async list() {
     return this.request("GET", `${this.prefix}`);
   }
@@ -279,6 +283,10 @@ var FunctionsService = class extends core.BaseService {
     return this.request("GET", `${this.prefix}/${seg(nameOrId)}`);
   }
   // -- Jobs -------------------------------------------------------------------
+  /**
+   * Liste les jobs asynchrones du projet, filtrés par `status` (`pending`, `running`, `completed`,
+   * `failed`, `dead`). `limit` va de 1 à 500 (50 par défaut). Exige une clé `service_role`.
+   */
   async listJobs(options) {
     const params = new URLSearchParams();
     if (options?.status) params.set("status", options.status);
@@ -286,6 +294,7 @@ var FunctionsService = class extends core.BaseService {
     const qs = params.toString() ? `?${params.toString()}` : "";
     return this.request("GET", `${this.prefix}/jobs${qs}`);
   }
+  /** Lit un job par son identifiant. Exige une clé `service_role`. */
   async getJob(jobId) {
     return this.request("GET", `${this.prefix}/jobs/${seg(jobId)}`);
   }
@@ -313,9 +322,15 @@ var FunctionsService = class extends core.BaseService {
     });
   }
   // -- Cron -------------------------------------------------------------------
+  /** Liste les tâches cron du projet. Exige une clé `service_role`. */
   async listCronJobs() {
     return this.request("GET", `${this.prefix}/cron`);
   }
+  /**
+   * Crée une tâche cron : à chaque échéance, un job est mis en file pour `functionName`.
+   * `schedule` compte 5 champs (`min heure jour mois jour-semaine`) ou 6 (avec les secondes), en UTC ;
+   * les alias comme `@daily` sont refusés. Le `payload` est figé à la création. Exige une clé `service_role`.
+   */
   async createCronJob(name, schedule, functionName, options) {
     return this.request("POST", `${this.prefix}/cron`, {
       name,
@@ -324,6 +339,10 @@ var FunctionsService = class extends core.BaseService {
       payload: options?.payload
     });
   }
+  /**
+   * Supprime une tâche cron par son NOM (et non son identifiant) ; un nom inconnu renvoie 404.
+   * La tâche cesse aussi de se déclencher. Exige une clé `service_role`.
+   */
   async deleteCronJob(name) {
     return this.request("DELETE", `${this.prefix}/cron/${seg(name)}`);
   }

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { AuraError, BaseService, AuraClientLike, AuraResponse, FunctionDef, Job, CronJob } from '@aurabase/core';
-export { AuraResponse, CronJob, FunctionDef, Job } from '@aurabase/core';
+export { AuraResponse, CronJob, FunctionDef, FunctionPermissions, Job } from '@aurabase/core';
 
 declare function isRelayStatus(status: number): boolean;
 /**
@@ -84,6 +84,10 @@ declare class FunctionsService extends BaseService {
         timeout?: number;
         responseType?: FunctionsResponseType;
     }): Promise<AuraResponse<T>>;
+    /**
+     * Liste les fonctions déployées du projet, avec leur code source et leurs variables.
+     * Exige une clé `service_role` : une clé publique reçoit `403`.
+     */
     list(): Promise<AuraResponse<FunctionDef[]>>;
     /**
      * Lit une fonction par son **nom** ou par son **identifiant** (B10).
@@ -93,10 +97,15 @@ declare class FunctionsService extends BaseService {
      * le NOM l'emporte. Une valeur qui n'est ni l'un ni l'autre produit un 404 qui le dit.
      */
     get(nameOrId: string): Promise<AuraResponse<FunctionDef>>;
+    /**
+     * Liste les jobs asynchrones du projet, filtrés par `status` (`pending`, `running`, `completed`,
+     * `failed`, `dead`). `limit` va de 1 à 500 (50 par défaut). Exige une clé `service_role`.
+     */
     listJobs(options?: {
         status?: string;
         limit?: number;
     }): Promise<AuraResponse<Job[]>>;
+    /** Lit un job par son identifiant. Exige une clé `service_role`. */
     getJob(jobId: string): Promise<AuraResponse<Job>>;
     /**
      * Enfile un job d'exécution asynchrone en arrière-plan pour une fonction.
@@ -110,10 +119,20 @@ declare class FunctionsService extends BaseService {
         delaySecs?: number;
         maxAttempts?: number;
     }): Promise<AuraResponse<Job>>;
+    /** Liste les tâches cron du projet. Exige une clé `service_role`. */
     listCronJobs(): Promise<AuraResponse<CronJob[]>>;
+    /**
+     * Crée une tâche cron : à chaque échéance, un job est mis en file pour `functionName`.
+     * `schedule` compte 5 champs (`min heure jour mois jour-semaine`) ou 6 (avec les secondes), en UTC ;
+     * les alias comme `@daily` sont refusés. Le `payload` est figé à la création. Exige une clé `service_role`.
+     */
     createCronJob(name: string, schedule: string, functionName: string, options?: {
         payload?: unknown;
     }): Promise<AuraResponse<CronJob>>;
+    /**
+     * Supprime une tâche cron par son NOM (et non son identifiant) ; un nom inconnu renvoie 404.
+     * La tâche cesse aussi de se déclencher. Exige une clé `service_role`.
+     */
     deleteCronJob(name: string): Promise<AuraResponse<null>>;
 }
 

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { AuraError, BaseService, AuraClientLike, AuraResponse, FunctionDef, Job, CronJob } from '@aurabase/core';
-export { AuraResponse, CronJob, FunctionDef, Job } from '@aurabase/core';
+export { AuraResponse, CronJob, FunctionDef, FunctionPermissions, Job } from '@aurabase/core';
 
 declare function isRelayStatus(status: number): boolean;
 /**
@@ -84,6 +84,10 @@ declare class FunctionsService extends BaseService {
         timeout?: number;
         responseType?: FunctionsResponseType;
     }): Promise<AuraResponse<T>>;
+    /**
+     * Liste les fonctions déployées du projet, avec leur code source et leurs variables.
+     * Exige une clé `service_role` : une clé publique reçoit `403`.
+     */
     list(): Promise<AuraResponse<FunctionDef[]>>;
     /**
      * Lit une fonction par son **nom** ou par son **identifiant** (B10).
@@ -93,10 +97,15 @@ declare class FunctionsService extends BaseService {
      * le NOM l'emporte. Une valeur qui n'est ni l'un ni l'autre produit un 404 qui le dit.
      */
     get(nameOrId: string): Promise<AuraResponse<FunctionDef>>;
+    /**
+     * Liste les jobs asynchrones du projet, filtrés par `status` (`pending`, `running`, `completed`,
+     * `failed`, `dead`). `limit` va de 1 à 500 (50 par défaut). Exige une clé `service_role`.
+     */
     listJobs(options?: {
         status?: string;
         limit?: number;
     }): Promise<AuraResponse<Job[]>>;
+    /** Lit un job par son identifiant. Exige une clé `service_role`. */
     getJob(jobId: string): Promise<AuraResponse<Job>>;
     /**
      * Enfile un job d'exécution asynchrone en arrière-plan pour une fonction.
@@ -110,10 +119,20 @@ declare class FunctionsService extends BaseService {
         delaySecs?: number;
         maxAttempts?: number;
     }): Promise<AuraResponse<Job>>;
+    /** Liste les tâches cron du projet. Exige une clé `service_role`. */
     listCronJobs(): Promise<AuraResponse<CronJob[]>>;
+    /**
+     * Crée une tâche cron : à chaque échéance, un job est mis en file pour `functionName`.
+     * `schedule` compte 5 champs (`min heure jour mois jour-semaine`) ou 6 (avec les secondes), en UTC ;
+     * les alias comme `@daily` sont refusés. Le `payload` est figé à la création. Exige une clé `service_role`.
+     */
     createCronJob(name: string, schedule: string, functionName: string, options?: {
         payload?: unknown;
     }): Promise<AuraResponse<CronJob>>;
+    /**
+     * Supprime une tâche cron par son NOM (et non son identifiant) ; un nom inconnu renvoie 404.
+     * La tâche cesse aussi de se déclencher. Exige une clé `service_role`.
+     */
     deleteCronJob(name: string): Promise<AuraResponse<null>>;
 }
 

package/dist/index.js

@@ -263,6 +263,10 @@ var FunctionsService = class extends BaseService {
     }
   }
   // -- Function CRUD ----------------------------------------------------------
+  /**
+   * Liste les fonctions déployées du projet, avec leur code source et leurs variables.
+   * Exige une clé `service_role` : une clé publique reçoit `403`.
+   */
   async list() {
     return this.request("GET", `${this.prefix}`);
   }
@@ -277,6 +281,10 @@ var FunctionsService = class extends BaseService {
     return this.request("GET", `${this.prefix}/${seg(nameOrId)}`);
   }
   // -- Jobs -------------------------------------------------------------------
+  /**
+   * Liste les jobs asynchrones du projet, filtrés par `status` (`pending`, `running`, `completed`,
+   * `failed`, `dead`). `limit` va de 1 à 500 (50 par défaut). Exige une clé `service_role`.
+   */
   async listJobs(options) {
     const params = new URLSearchParams();
     if (options?.status) params.set("status", options.status);
@@ -284,6 +292,7 @@ var FunctionsService = class extends BaseService {
     const qs = params.toString() ? `?${params.toString()}` : "";
     return this.request("GET", `${this.prefix}/jobs${qs}`);
   }
+  /** Lit un job par son identifiant. Exige une clé `service_role`. */
   async getJob(jobId) {
     return this.request("GET", `${this.prefix}/jobs/${seg(jobId)}`);
   }
@@ -311,9 +320,15 @@ var FunctionsService = class extends BaseService {
     });
   }
   // -- Cron -------------------------------------------------------------------
+  /** Liste les tâches cron du projet. Exige une clé `service_role`. */
   async listCronJobs() {
     return this.request("GET", `${this.prefix}/cron`);
   }
+  /**
+   * Crée une tâche cron : à chaque échéance, un job est mis en file pour `functionName`.
+   * `schedule` compte 5 champs (`min heure jour mois jour-semaine`) ou 6 (avec les secondes), en UTC ;
+   * les alias comme `@daily` sont refusés. Le `payload` est figé à la création. Exige une clé `service_role`.
+   */
   async createCronJob(name, schedule, functionName, options) {
     return this.request("POST", `${this.prefix}/cron`, {
       name,
@@ -322,6 +337,10 @@ var FunctionsService = class extends BaseService {
       payload: options?.payload
     });
   }
+  /**
+   * Supprime une tâche cron par son NOM (et non son identifiant) ; un nom inconnu renvoie 404.
+   * La tâche cesse aussi de se déclencher. Exige une clé `service_role`.
+   */
   async deleteCronJob(name) {
     return this.request("DELETE", `${this.prefix}/cron/${seg(name)}`);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aurabase/functions",
-  "version": "0.6.0",
+  "version": "0.6.2",
   "description": "Service edge functions du SDK Aurabase (invoke, jobs asynchrones, cron)",
   "type": "module",
   "main": "dist/index.cjs",
@@ -31,12 +31,12 @@
   "author": "Aurabase",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/daylami555/aurabase.git",
+    "url": "git+https://github.com/Aurabase-cloud/Aurabase.git",
     "directory": "aurabase-js/packages/functions"
   },
   "homepage": "https://aurabase.cloud",
   "bugs": {
-    "url": "https://github.com/daylami555/aurabase/issues"
+    "url": "https://github.com/Aurabase-cloud/Aurabase/issues"
   },
   "keywords": [
     "aurabase",
@@ -45,7 +45,7 @@
     "functions"
   ],
   "dependencies": {
-    "@aurabase/core": "0.6.0"
+    "@aurabase/core": "0.6.2"
   },
   "devDependencies": {
     "@types/node": "20.14.15",