@gigadrive/sdk 0.2.0 → 0.4.0

package/dist/index.js

@@ -37,6 +37,7 @@ __export(src_exports, {
   AiGatewayUsageResource: () => AiGatewayUsageResource,
   AiGatewayVideosResource: () => AiGatewayVideosResource,
   ApiError: () => ApiError,
+  ApiKeysResource: () => ApiKeysResource,
   ApplicationEnvVarsResource: () => ApplicationEnvVarsResource,
   ApplicationRequestsResource: () => ApplicationRequestsResource,
   ApplicationStorageResource: () => ApplicationStorageResource,
@@ -47,6 +48,8 @@ __export(src_exports, {
   GigadriveError: () => GigadriveError,
   OrganizationAiGatewayResource: () => OrganizationAiGatewayResource,
   OrganizationEnvVarsResource: () => OrganizationEnvVarsResource,
+  OrganizationMembersResource: () => OrganizationMembersResource,
+  OrganizationProductsResource: () => OrganizationProductsResource,
   OrganizationsResource: () => OrganizationsResource,
   StorageBucketsResource: () => StorageBucketsResource,
   StorageObjectsResource: () => StorageObjectsResource,
@@ -785,6 +788,39 @@ var AiGatewayResource = class extends BaseResource {
   }
 };
 
+// src/resources/api-keys.ts
+var ApiKeysResource = class extends BaseResource {
+  /**
+   * Provision a new application-scoped API key. The plaintext secret is returned
+   * exactly once — store it immediately.
+   *
+   * @param data - The key name, target application, and optional scopes/expiry.
+   * @returns The created key including its one-time plaintext secret.
+   */
+  async create(data) {
+    return this.httpClient.post("/api-keys", data);
+  }
+  /**
+   * List the API keys scoped to an application. Secrets are never returned.
+   *
+   * @param query - The application whose keys should be listed.
+   * @returns A paginated list of API key metadata.
+   */
+  async list(query) {
+    return this.httpClient.get("/api-keys", {
+      query
+    });
+  }
+  /**
+   * Permanently revoke an API key.
+   *
+   * @param apiKeyId - The API key ID (UUID).
+   */
+  async delete(apiKeyId) {
+    return this.httpClient.delete(`/api-keys/${apiKeyId}`);
+  }
+};
+
 // src/resources/application-env-vars.ts
 var ApplicationEnvVarsResource = class extends BaseResource {
   /**
@@ -806,6 +842,27 @@ var ApplicationEnvVarsResource = class extends BaseResource {
       query
     });
   }
+  /**
+   * Pull the environment variables that apply to an application for local
+   * development. Merges organization-wide, application-wide, and (optionally)
+   * environment-specific overrides, returning only non-sensitive values — ready
+   * to write to a local `.env` file.
+   *
+   * @param applicationId - The application ID (UUID).
+   * @param query - Optional environment targeting.
+   * @returns The resolved non-sensitive variables plus the count of omitted secrets.
+   *
+   * @example
+   * ```ts
+   * const { items } = await client.applications.envVars.pull('app-id');
+   * const dotenv = items.map((v) => `${v.key}=${v.value}`).join('\n');
+   * ```
+   */
+  async pull(applicationId, query) {
+    return this.httpClient.get(`/applications/${applicationId}/env-vars/pull`, {
+      query
+    });
+  }
   /**
    * Create a new environment variable for an application.
    *
@@ -2033,6 +2090,83 @@ var OrganizationEnvVarsResource = class extends BaseResource {
   }
 };
 
+// src/resources/organization-members.ts
+var OrganizationMembersResource = class extends BaseResource {
+  /**
+   * List the users who belong to an organization.
+   *
+   * @param organizationId - Organization whose members should be listed.
+   * @param query - Optional pagination.
+   * @returns A paginated list of organization members.
+   *
+   * @example
+   * ```ts
+   * const { items, total } = await client.organizations.members.list('org-id');
+   * console.log(`Found ${total} members`);
+   * ```
+   */
+  async list(organizationId, query) {
+    return this.httpClient.get(`/organizations/${organizationId}/members`, {
+      query
+    });
+  }
+};
+
+// src/resources/organization-products.ts
+var OrganizationProductsResource = class extends BaseResource {
+  /**
+   * List effective product access for every organization-scoped product.
+   *
+   * @param organizationId - Organization whose product access should be listed.
+   * @param query - Optional pagination.
+   * @returns A paginated list of product access summaries.
+   *
+   * @example
+   * ```ts
+   * const { items } = await client.organizations.products.list('org-id');
+   * for (const item of items) {
+   *   console.log(item.product.slug, item.hasAccess);
+   * }
+   * ```
+   */
+  async list(organizationId, query) {
+    return this.httpClient.get(`/organizations/${organizationId}/products`, {
+      query
+    });
+  }
+  /**
+   * Get effective access for one organization-scoped product.
+   *
+   * @param organizationId - Organization to inspect.
+   * @param product - Product slug from the product registry.
+   * @returns Product access summary including entitlement and subscription state.
+   *
+   * @example
+   * ```ts
+   * const access = await client.organizations.products.get('org-id', 'office');
+   * console.log(access.hasAccess, access.subscription?.plan);
+   * ```
+   */
+  async get(organizationId, product) {
+    return this.httpClient.get(`/organizations/${organizationId}/products/${product}`);
+  }
+  /**
+   * Check whether an organization currently has access to a product.
+   *
+   * @param organizationId - Organization to check.
+   * @param product - Product slug from the product registry.
+   * @returns Compact entitlement check result.
+   *
+   * @example
+   * ```ts
+   * const { hasAccess } = await client.organizations.products.checkEntitlement('org-id', 'network');
+   * ```
+   */
+  async checkEntitlement(organizationId, product) {
+    return this.httpClient.get(`/organizations/${organizationId}/products/${product}/entitlement`);
+  }
+};
+
 // src/resources/organizations.ts
 var OrganizationsResource = class extends BaseResource {
   /**
@@ -2063,10 +2197,31 @@ var OrganizationsResource = class extends BaseResource {
    * ```
    */
   aiGateway;
+  /**
+   * List organization members and membership roles.
+   *
+   * @example
+   * ```ts
+   * const { items } = await client.organizations.members.list('org-id');
+   * ```
+   */
+  members;
+  /**
+   * Inspect organization product entitlements. Read-only through the public
+   * API — plan changes happen in Gigadrive product surfaces, not via the SDK.
+   *
+   * @example
+   * ```ts
+   * const check = await client.organizations.products.checkEntitlement('org-id', 'office');
+   * ```
+   */
+  products;
   constructor(...args) {
     super(...args);
     this.envVars = new OrganizationEnvVarsResource(this.httpClient);
     this.aiGateway = new OrganizationAiGatewayResource(this.httpClient);
+    this.members = new OrganizationMembersResource(this.httpClient);
+    this.products = new OrganizationProductsResource(this.httpClient);
   }
   /**
    * List organizations the authenticated actor has access to.
@@ -2085,6 +2240,39 @@ var OrganizationsResource = class extends BaseResource {
       query
     });
   }
+  /**
+   * Get a single organization by ID.
+   *
+   * @param organizationId - Organization to retrieve.
+   * @returns The organization.
+   *
+   * @example
+   * ```ts
+   * const org = await client.organizations.get('org-id');
+   * console.log(org.name, org.slug);
+   * ```
+   */
+  async get(organizationId) {
+    return this.httpClient.get(`/organizations/${organizationId}`);
+  }
+  /**
+   * Create a new organization.
+   *
+   * Requires a user-backed token with the `platform:organizations:write` scope.
+   * The authenticated user becomes the organization owner.
+   *
+   * @param input - Organization creation input.
+   * @returns The created organization.
+   *
+   * @example
+   * ```ts
+   * const org = await client.organizations.create({ name: 'Acme Corp' });
+   * console.log(org.id, org.slug);
+   * ```
+   */
+  async create(input) {
+    return this.httpClient.post("/organizations", input);
+  }
 };
 
 // src/client.ts
@@ -2098,6 +2286,8 @@ var GigadriveClient = class {
   deployments;
   /** AI Gateway — OpenAI-compatible chat completions and model listing. */
   aiGateway;
+  /** Application-scoped API key management (create, list, revoke). */
+  apiKeys;
   constructor(config = {}) {
     const baseUrl = config.baseUrl ?? readEnv("GIGADRIVE_API_BASE_URL") ?? DEFAULT_BASE_URL2;
     const fetchFn = config.fetch ?? globalThis.fetch.bind(globalThis);
@@ -2108,6 +2298,7 @@ var GigadriveClient = class {
     this.applications = new ApplicationsResource(httpClient);
     this.deployments = new DeploymentsResource(httpClient);
     this.aiGateway = new AiGatewayResource(httpClient);
+    this.apiKeys = new ApiKeysResource(httpClient);
   }
 };
 
@@ -2131,6 +2322,7 @@ async function* paginate(fetchPage) {
   AiGatewayUsageResource,
   AiGatewayVideosResource,
   ApiError,
+  ApiKeysResource,
   ApplicationEnvVarsResource,
   ApplicationRequestsResource,
   ApplicationStorageResource,
@@ -2141,6 +2333,8 @@ async function* paginate(fetchPage) {
   GigadriveError,
   OrganizationAiGatewayResource,
   OrganizationEnvVarsResource,
+  OrganizationMembersResource,
+  OrganizationProductsResource,
   OrganizationsResource,
   StorageBucketsResource,
   StorageObjectsResource,