@studiometa/forge-sdk 0.4.5 → 0.4.7

package/dist/resources/php.d.ts

@@ -0,0 +1,151 @@
+import type { HttpClient, PhpVersionAttributes } from "@studiometa/forge-api";
+import { BaseCollection } from "./base.ts";
+/**
+ * The PHP configuration files that Forge can read and write.
+ */
+export declare const PHP_CONFIG_TYPES: readonly ["cli", "fpm", "pool"];
+/**
+ * A PHP configuration file that Forge can read and write.
+ */
+export type PhpConfigType = (typeof PHP_CONFIG_TYPES)[number];
+/**
+ * Options for listing PHP versions.
+ */
+export interface PhpVersionListOptions {
+    /** Cursor for pagination (from previous response's next_cursor). */
+    cursor?: string;
+}
+/**
+ * Options for reading or writing a PHP configuration file.
+ */
+export interface PhpConfigOptions {
+    /** Unix user of the FPM pool (pool only). */
+    user?: string;
+}
+/**
+ * PHP on a server — installed versions, configuration files, limits and OPcache.
+ *
+ * Access via `forge.server(id).php`.
+ *
+ * Version methods take the PHP version ID from `list()`.
+ *
+ * @example
+ * ```ts
+ * const versions = await forge.server(123).php.list();
+ * const fpm = await forge.server(123).php.config(versions[0].id, 'fpm');
+ * await forge.server(123).php.setMaxUploadSize(64);
+ * await forge.server(123).php.enableOpcache();
+ * ```
+ */
+export declare class PhpResource extends BaseCollection {
+    private readonly serverId;
+    /** @internal */
+    constructor(client: HttpClient, orgSlug: string, serverId: number);
+    private get basePath();
+    /**
+     * List the PHP versions installed on this server.
+     *
+     * @example
+     * ```ts
+     * const versions = await forge.server(123).php.list();
+     * // → [{ id: 12, version: '8.3', binary_name: 'php8.3', status: 'installed', ... }]
+     * ```
+     */
+    list(options?: PhpVersionListOptions): Promise<Array<PhpVersionAttributes & {
+        id: number;
+    }>>;
+    /**
+     * Get one installed PHP version.
+     *
+     * @example
+     * ```ts
+     * const version = await forge.server(123).php.get(12);
+     * ```
+     */
+    get(versionId: number): Promise<PhpVersionAttributes & {
+        id: number;
+    }>;
+    /**
+     * Get a PHP configuration file (cli, fpm or pool) of a version.
+     *
+     * @example
+     * ```ts
+     * const ini = await forge.server(123).php.config(12, 'fpm');
+     * const pool = await forge.server(123).php.config(12, 'pool', { user: 'forge' });
+     * ```
+     */
+    config(versionId: number, type: PhpConfigType, options?: PhpConfigOptions): Promise<string>;
+    /**
+     * Replace a PHP configuration file (cli, fpm or pool) of a version.
+     *
+     * @example
+     * ```ts
+     * await forge.server(123).php.updateConfig(12, 'fpm', 'memory_limit = 512M\n...');
+     * ```
+     */
+    updateConfig(versionId: number, type: PhpConfigType, content: string, options?: PhpConfigOptions): Promise<void>;
+    /**
+     * Get the PHP max upload size, in megabytes.
+     *
+     * @example
+     * ```ts
+     * const size = await forge.server(123).php.maxUploadSize(); // → "64"
+     * ```
+     */
+    maxUploadSize(): Promise<string>;
+    /**
+     * Set the PHP max upload size, in megabytes.
+     *
+     * @example
+     * ```ts
+     * await forge.server(123).php.setMaxUploadSize(128);
+     * ```
+     */
+    setMaxUploadSize(size: number): Promise<void>;
+    /**
+     * Get the PHP max execution time, in seconds.
+     *
+     * @example
+     * ```ts
+     * const seconds = await forge.server(123).php.maxExecutionTime(); // → "60"
+     * ```
+     */
+    maxExecutionTime(): Promise<string>;
+    /**
+     * Set the PHP max execution time, in seconds.
+     *
+     * @example
+     * ```ts
+     * await forge.server(123).php.setMaxExecutionTime(120);
+     * ```
+     */
+    setMaxExecutionTime(seconds: number): Promise<void>;
+    /**
+     * Get whether OPcache is enabled.
+     *
+     * @example
+     * ```ts
+     * const enabled = await forge.server(123).php.opcache(); // → true
+     * ```
+     */
+    opcache(): Promise<boolean>;
+    /**
+     * Enable OPcache.
+     *
+     * @example
+     * ```ts
+     * await forge.server(123).php.enableOpcache();
+     * ```
+     */
+    enableOpcache(): Promise<void>;
+    /**
+     * Disable OPcache.
+     *
+     * @example
+     * ```ts
+     * await forge.server(123).php.disableOpcache();
+     * ```
+     */
+    disableOpcache(): Promise<void>;
+}
+//# sourceMappingURL=php.d.ts.map

package/dist/resources/php.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"php.d.ts","sourceRoot":"","sources":["../../src/resources/php.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EAOV,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAI/B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,gBAAgB,YAAI,KAAK,EAAE,KAAK,EAAE,MAAM,CAAU,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAkBD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,WAAY,SAAQ,cAAc;IAK3C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,gBAAgB;IAChB,YACE,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACE,QAAQ,EAAE,MAAM,EAGlC;IAED,OAAO,KAAK,QAAQ,GAEnB;IAED;;;;;;;;OAQG;IACG,IAAI,CACR,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,KAAK,CAAC,oBAAoB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAMvD;IAED;;;;;;;OAOG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAK3E;IAED;;;;;;;;OAQG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,EACnB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAOjB;IAED;;;;;;;OAOG;IACG,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,IAAI,CAAC,CAMf;IAED;;;;;;;OAOG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC,CAKrC;IAED;;;;;;;OAOG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAElD;IAED;;;;;;;OAOG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC,CAKxC;IAED;;;;;;;OAOG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAExD;IAED;;;;;;;OAOG;IACG,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAKhC;IAED;;;;;;;OAOG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnC;IAED;;;;;;;OAOG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;CACF"}

package/dist/resources/servers.d.ts

@@ -10,6 +10,8 @@ import { MonitorsCollection } from "./monitors.ts";
 import { FirewallRulesCollection } from "./firewall-rules.ts";
 import { SshKeysCollection } from "./ssh-keys.ts";
 import { NginxTemplatesCollection } from "./nginx-templates.ts";
+import { ServicesCollection } from "./services.ts";
+import { PhpResource } from "./php.ts";
 import { BaseCollection } from "./base.ts";
 /**
  * A matched resource item with ID and name.
@@ -200,6 +202,10 @@ export declare class ServerResource extends BaseCollection {
     readonly sshKeys: SshKeysCollection;
     /** Nginx templates on this server. */
     readonly nginxTemplates: NginxTemplatesCollection;
+    /** Services (nginx, php, mysql, etc.) on this server. */
+    readonly services: ServicesCollection;
+    /** PHP versions, configuration files, limits and OPcache on this server. */
+    readonly php: PhpResource;
     /** @internal */
     constructor(client: HttpClient, orgSlug: string, serverId: number);
     /**

package/dist/resources/servers.d.ts.map

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

package/dist/resources/services.d.ts

@@ -0,0 +1,74 @@
+import type { HttpClient } from "@studiometa/forge-api";
+import { BaseCollection } from "./base.ts";
+/**
+ * The six restartable services exposed by the Forge v2 API.
+ */
+export declare const RESTARTABLE_SERVICES: readonly ["nginx", "php", "mysql", "postgres", "redis", "supervisor"];
+export type RestartableService = (typeof RESTARTABLE_SERVICES)[number];
+/**
+ * A single service availability row.
+ *
+ * `available` is a documented heuristic derived from the server object, since
+ * the API has no services GET endpoint.
+ */
+export interface ServiceStatus {
+    service: string;
+    available: boolean;
+    detail: string | null;
+}
+/**
+ * Options for restarting a service.
+ */
+export interface RestartServiceOptions {
+    /** PHP version (e.g. "php83") — required when restarting the php service. */
+    version?: string;
+}
+/**
+ * Services on a server — list availability and restart individual services.
+ *
+ * Access via `forge.server(id).services`.
+ *
+ * The v2 API has no GET endpoint for services, so `list()` derives availability
+ * from the server object. Restarting maps to the API action `reboot`.
+ *
+ * @example
+ * ```ts
+ * // List services and their availability
+ * const services = await forge.server(123).services.list();
+ *
+ * // Restart nginx
+ * await forge.server(123).services.restart('nginx');
+ *
+ * // Restart php (version required)
+ * await forge.server(123).services.restart('php', { version: 'php83' });
+ * ```
+ */
+export declare class ServicesCollection extends BaseCollection {
+    private readonly serverId;
+    /** @internal */
+    constructor(client: HttpClient, orgSlug: string, serverId: number);
+    private get basePath();
+    /**
+     * List services on this server with a derived availability flag.
+     *
+     * @example
+     * ```ts
+     * const services = await forge.server(123).services.list();
+     * // → [{ service: 'nginx', available: true, detail: null }, ...]
+     * ```
+     */
+    list(): Promise<ServiceStatus[]>;
+    /**
+     * Restart a service on this server.
+     *
+     * Maps to the API action `reboot`. The php service requires a `version`.
+     *
+     * @example
+     * ```ts
+     * await forge.server(123).services.restart('nginx');
+     * await forge.server(123).services.restart('php', { version: 'php83' });
+     * ```
+     */
+    restart(service: string, options?: RestartServiceOptions): Promise<void>;
+}
+//# sourceMappingURL=services.d.ts.map

package/dist/resources/services.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../../src/resources/services.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAqC,MAAM,uBAAuB,CAAC;AAI3F,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,oBAAoB,YAC/B,OAAO,EACP,KAAK,EACL,OAAO,EACP,UAAU,EACV,OAAO,EACP,YAAY,CACJ,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IAKlD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,gBAAgB;IAChB,YACE,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,MAAM,EACE,QAAQ,EAAE,MAAM,EAGlC;IAED,OAAO,KAAK,QAAQ,GAEnB;IAED;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAoBrC;IAED;;;;;;;;;;OAUG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAejF;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studiometa/forge-sdk",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "description": "Laravel Forge TypeScript SDK — fluent, chainable, fully-typed API client",
   "keywords": [
     "api-client",
@@ -44,7 +44,7 @@
     "typecheck": "tsgo -p tsconfig.typecheck.json --noEmit"
   },
   "dependencies": {
-    "@studiometa/forge-api": "0.4.5"
+    "@studiometa/forge-api": "0.4.7"
   },
   "devDependencies": {
     "@typescript/native-preview": "^7.0.0-dev.20260409.1",