@sylphx/management 0.5.0 → 0.6.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @sylphx/management
 
+## 0.6.0
+
+### Minor Changes
+
+- [#1019](https://github.com/SylphxAI/platform/pull/1019) [`7978a14`](https://github.com/SylphxAI/platform/commit/7978a140c6eaf146456a458aa89b943cd3989659) Thanks [@shtse8](https://github.com/shtse8)! - Fail closed when environment targeting is ambiguous across platform management APIs.
+
+  The contract, Management SDK, and CLI now preserve explicit `envId` targeting for env vars, domains, services, deployments, and logs instead of relying on `envType` defaults when a project has multiple matching environments.
+
+### Patch Changes
+
+- Updated dependencies [[`7978a14`](https://github.com/SylphxAI/platform/commit/7978a140c6eaf146456a458aa89b943cd3989659)]:
+  - @sylphx/contract@0.8.0
+
 ## 0.5.0
 
 ### Minor Changes

package/dist/domains.d.ts

@@ -11,10 +11,14 @@ import type { Client } from './client.js';
 export interface OrgScopedRequestOptions {
     readonly orgId?: string;
 }
-export declare const list: (client: Client, projectId: string, envType?: string, options?: OrgScopedRequestOptions) => Promise<DomainResult[]>;
-export declare const create: (client: Client, projectId: string, apexDomain: string, envType?: string, options?: OrgScopedRequestOptions) => Promise<DomainResult>;
+export interface EnvironmentTargetRequestOptions extends OrgScopedRequestOptions {
+    readonly envId?: string;
+}
+export declare const list: (client: Client, projectId: string, envType?: string, options?: EnvironmentTargetRequestOptions) => Promise<DomainResult[]>;
+export declare const create: (client: Client, projectId: string, apexDomain: string, envType?: string, options?: EnvironmentTargetRequestOptions) => Promise<DomainResult>;
 export interface AddHostnameOpts extends Omit<AddHostnameInput, 'hostname'> {
     readonly envType?: string;
+    readonly envId?: string;
 }
 export declare const addHostname: (client: Client, projectId: string, domainId: string, hostname: string, opts: AddHostnameOpts, options?: OrgScopedRequestOptions) => Promise<DomainHostname>;
 export declare const removeHostname: (client: Client, projectId: string, domainId: string, hostnameId: string, options?: OrgScopedRequestOptions) => Promise<void>;

package/dist/domains.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../src/domains.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,MAAM,IAAI,YAAY,EACtB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAQD,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,gBAAsB,EACtB,UAAS,uBAA4B,KACnC,OAAO,CAAC,YAAY,EAAE,CAMxB,CAAA;AAED,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,YAAY,MAAM,EAClB,gBAAsB,EACtB,UAAS,uBAA4B,KACnC,OAAO,CAAC,YAAY,CAMtB,CAAA;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,eAAO,MAAM,WAAW,GACvB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,UAAU,MAAM,EAChB,MAAM,eAAe,EACrB,UAAS,uBAA4B,KACnC,OAAO,CAAC,cAAc,CAQxB,CAAA;AAED,eAAO,MAAM,cAAc,GAC1B,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,UAAS,uBAA4B,KACnC,OAAO,CAAC,IAAI,CAKd,CAAA;AAID,eAAO,MAAM,aAAa,GACzB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,UAAS,uBAA4B,KACnC,OAAO,CAAC,cAAc,CAMvB,CAAA;AAEF,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,eAAO,MAAM,WAAW,GACvB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,OAAO,eAAe,EACtB,UAAS,uBAA4B,KACnC,OAAO,CAAC,kBAAkB,CAM3B,CAAA;AAEF,eAAO,MAAM,UAAU,GACtB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,UAAS,uBAA4B,KACnC,OAAO,CAAC,kBAAkB,CAM3B,CAAA;AAEF,eAAO,MAAM,YAAY,GACxB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,UAAS,uBAA4B,KACnC,OAAO,CAAC,IAAI,CAMb,CAAA"}
+{"version":3,"file":"domains.d.ts","sourceRoot":"","sources":["../src/domains.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,MAAM,IAAI,YAAY,EACtB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,+BAAgC,SAAQ,uBAAuB;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAQD,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,gBAAsB,EACtB,UAAS,+BAAoC,KAC3C,OAAO,CAAC,YAAY,EAAE,CAMxB,CAAA;AAED,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,YAAY,MAAM,EAClB,gBAAsB,EACtB,UAAS,+BAAoC,KAC3C,OAAO,CAAC,YAAY,CAMtB,CAAA;AAED,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,eAAO,MAAM,WAAW,GACvB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,UAAU,MAAM,EAChB,MAAM,eAAe,EACrB,UAAS,uBAA4B,KACnC,OAAO,CAAC,cAAc,CAQxB,CAAA;AAED,eAAO,MAAM,cAAc,GAC1B,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,UAAS,uBAA4B,KACnC,OAAO,CAAC,IAAI,CAKd,CAAA;AAID,eAAO,MAAM,aAAa,GACzB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,YAAY,MAAM,EAClB,UAAS,uBAA4B,KACnC,OAAO,CAAC,cAAc,CAMvB,CAAA;AAEF,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,eAAO,MAAM,WAAW,GACvB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,OAAO,eAAe,EACtB,UAAS,uBAA4B,KACnC,OAAO,CAAC,kBAAkB,CAM3B,CAAA;AAEF,eAAO,MAAM,UAAU,GACtB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,UAAS,uBAA4B,KACnC,OAAO,CAAC,kBAAkB,CAM3B,CAAA;AAEF,eAAO,MAAM,YAAY,GACxB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,MAAM,EAChB,UAAS,uBAA4B,KACnC,OAAO,CAAC,IAAI,CAMb,CAAA"}

package/dist/domains.js

@@ -14,22 +14,22 @@ const orgHeaders = (options = {}) => ({
 export const list = (client, projectId, envType = 'production', options = {}) => {
     const { method, path } = domainsEndpoints.list;
     return request(client, method, interpolatePath(path, { projectId }), {
-        query: { envType },
+        query: { envType, envId: options.envId },
         headers: orgHeaders(options),
     });
 };
 export const create = (client, projectId, apexDomain, envType = 'production', options = {}) => {
     const { method, path } = domainsEndpoints.create;
     return request(client, method, interpolatePath(path, { projectId }), {
-        body: { apexDomain, envType },
+        body: { apexDomain, envType, envId: options.envId },
         headers: orgHeaders(options),
     });
 };
 export const addHostname = (client, projectId, domainId, hostname, opts, options = {}) => {
     const { method, path } = domainsEndpoints.addHostname;
-    const { envType = 'production', ...body } = opts;
+    const { envType = 'production', envId, ...body } = opts;
     return request(client, method, interpolatePath(path, { projectId, domainId }), {
-        query: { envType },
+        query: { envType, envId },
         body: { hostname, ...body },
         headers: orgHeaders(options),
     });

package/dist/envVars.d.ts

@@ -8,13 +8,16 @@ import type { Client } from './client.js';
 export interface OrgScopedRequestOptions {
     readonly orgId?: string;
 }
-export declare const list: (client: Client, projectId: string, envType: string, options?: OrgScopedRequestOptions) => Promise<EnvVar[]>;
-export declare const set: (client: Client, projectId: string, key: string, value: string, envType: string, secret?: boolean, options?: OrgScopedRequestOptions) => Promise<void>;
+export interface EnvironmentTargetRequestOptions extends OrgScopedRequestOptions {
+    readonly envId?: string;
+}
+export declare const list: (client: Client, projectId: string, envType: string, options?: EnvironmentTargetRequestOptions) => Promise<EnvVar[]>;
+export declare const set: (client: Client, projectId: string, key: string, value: string, envType: string, secret?: boolean, options?: EnvironmentTargetRequestOptions) => Promise<void>;
 export declare const setMany: (client: Client, projectId: string, vars: ReadonlyArray<{
     key: string;
     value: string;
     secret?: boolean;
-}>, envType: string, options?: OrgScopedRequestOptions) => Promise<void>;
-declare const _delete: (client: Client, projectId: string, key: string, envType: string, options?: OrgScopedRequestOptions) => Promise<void>;
+}>, envType: string, options?: EnvironmentTargetRequestOptions) => Promise<void>;
+declare const _delete: (client: Client, projectId: string, key: string, envType: string, options?: EnvironmentTargetRequestOptions) => Promise<void>;
 export { _delete as delete };
 //# sourceMappingURL=envVars.d.ts.map

package/dist/envVars.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"envVars.d.ts","sourceRoot":"","sources":["../src/envVars.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAQD,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,UAAS,uBAA4B,KACnC,OAAO,CAAC,MAAM,EAAE,CASlB,CAAA;AAED,eAAO,MAAM,GAAG,GACf,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,KAAK,MAAM,EACX,OAAO,MAAM,EACb,SAAS,MAAM,EACf,SAAS,OAAO,EAChB,UAAS,uBAA4B,KACnC,OAAO,CAAC,IAAI,CASd,CAAA;AAED,eAAO,MAAM,OAAO,GACnB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,MAAM,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,EACrE,SAAS,MAAM,EACf,UAAS,uBAA4B,KACnC,OAAO,CAAC,IAAI,CAMd,CAAA;AAED,QAAA,MAAM,OAAO,GACZ,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,KAAK,MAAM,EACX,SAAS,MAAM,EACf,UAAS,uBAA4B,KACnC,OAAO,CAAC,IAAI,CAMd,CAAA;AACD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,CAAA"}
+{"version":3,"file":"envVars.d.ts","sourceRoot":"","sources":["../src/envVars.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,+BAAgC,SAAQ,uBAAuB;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAQD,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,UAAS,+BAAoC,KAC3C,OAAO,CAAC,MAAM,EAAE,CASlB,CAAA;AAED,eAAO,MAAM,GAAG,GACf,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,KAAK,MAAM,EACX,OAAO,MAAM,EACb,SAAS,MAAM,EACf,SAAS,OAAO,EAChB,UAAS,+BAAoC,KAC3C,OAAO,CAAC,IAAI,CAUd,CAAA;AAED,eAAO,MAAM,OAAO,GACnB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,MAAM,aAAa,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,EACrE,SAAS,MAAM,EACf,UAAS,+BAAoC,KAC3C,OAAO,CAAC,IAAI,CAMd,CAAA;AAED,QAAA,MAAM,OAAO,GACZ,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,KAAK,MAAM,EACX,SAAS,MAAM,EACf,UAAS,+BAAoC,KAC3C,OAAO,CAAC,IAAI,CAMd,CAAA;AACD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,CAAA"}

package/dist/envVars.js

@@ -10,7 +10,7 @@ const orgHeaders = (options = {}) => ({
 });
 export const list = async (client, projectId, envType, options = {}) => {
     const { method, path } = envVarsEndpoints.list;
-    const res = await request(client, method, interpolatePath(path, { id: projectId }), { query: { envType }, headers: orgHeaders(options) });
+    const res = await request(client, method, interpolatePath(path, { id: projectId }), { query: { envType, envId: options.envId }, headers: orgHeaders(options) });
     return Array.isArray(res) ? res : (res.data ?? []);
 };
 export const set = (client, projectId, key, value, envType, secret, options = {}) => {
@@ -18,6 +18,7 @@ export const set = (client, projectId, key, value, envType, secret, options = {}
     return request(client, method, interpolatePath(path, { id: projectId }), {
         body: {
             envType,
+            envId: options.envId,
             vars: [{ key, value, secret: secret ?? false }],
         },
         headers: orgHeaders(options),
@@ -26,14 +27,14 @@ export const set = (client, projectId, key, value, envType, secret, options = {}
 export const setMany = (client, projectId, vars, envType, options = {}) => {
     const { method, path } = envVarsEndpoints.set;
     return request(client, method, interpolatePath(path, { id: projectId }), {
-        body: { envType, vars },
+        body: { envType, envId: options.envId, vars },
         headers: orgHeaders(options),
     });
 };
 const _delete = (client, projectId, key, envType, options = {}) => {
     const { method, path } = envVarsEndpoints.delete;
     return request(client, method, interpolatePath(path, { id: projectId, key }), {
-        query: { envType },
+        query: { envType, envId: options.envId },
         headers: orgHeaders(options),
     });
 };

package/dist/environments.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"environments.d.ts","sourceRoot":"","sources":["../src/environments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,sBAAsB,EACtB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAQD,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAS,uBAA4B,KACnC,OAAO,CAAC,WAAW,EAAE,CASvB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GACrB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,UAAS,uBAA4B,KACnC,OAAO,CAAC,MAAM,GAAG,IAAI,CASvB,CAAA;AAED,eAAO,MAAM,OAAO,GACnB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,aAAa,MAAM,EACnB,aAAa,MAAM,EACnB,UAAS,uBAA4B,KACnC,OAAO,CAAC,aAAa,CAMvB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,sBAAsB,CAAA;AAChD,MAAM,MAAM,YAAY,GAAG,uBAAuB,CAAA;AAElD,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,OAAO,WAAW,EAClB,UAAS,uBAA4B,KACnC,OAAO,CAAC,YAAY,CAMtB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,sBAAsB,CAAA;AAEhD,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,OAAO,WAAW,EAClB,UAAS,uBAA4B,KACnC,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAMtC,CAAA;AAED,QAAA,MAAM,OAAO,GACZ,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,UAAS,uBAA4B,KACnC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAGlD,CAAA;AACD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,CAAA;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,KAAK,GACjB,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,MAAM;IACL,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAClC,EACD,UAAS,uBAA4B,KACnC,OAAO,CAAC,YAAY,CAIpB,CAAA"}
+{"version":3,"file":"environments.d.ts","sourceRoot":"","sources":["../src/environments.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACX,sBAAsB,EACtB,uBAAuB,EACvB,WAAW,EACX,aAAa,EACb,sBAAsB,EACtB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAIzC,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAQD,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAS,uBAA4B,KACnC,OAAO,CAAC,WAAW,EAAE,CASvB,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,GACrB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,UAAS,uBAA4B,KACnC,OAAO,CAAC,MAAM,GAAG,IAAI,CAqBvB,CAAA;AAED,eAAO,MAAM,OAAO,GACnB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,aAAa,MAAM,EACnB,aAAa,MAAM,EACnB,UAAS,uBAA4B,KACnC,OAAO,CAAC,aAAa,CAMvB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,sBAAsB,CAAA;AAChD,MAAM,MAAM,YAAY,GAAG,uBAAuB,CAAA;AAElD,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,OAAO,WAAW,EAClB,UAAS,uBAA4B,KACnC,OAAO,CAAC,YAAY,CAMtB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,sBAAsB,CAAA;AAEhD,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,OAAO,WAAW,EAClB,UAAS,uBAA4B,KACnC,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAMtC,CAAA;AAED,QAAA,MAAM,OAAO,GACZ,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,UAAS,uBAA4B,KACnC,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAGlD,CAAA;AACD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,CAAA;AAE5B;;;;;GAKG;AACH,eAAO,MAAM,KAAK,GACjB,QAAQ,MAAM,EACd,aAAa,MAAM,EACnB,MAAM;IACL,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CAClC,EACD,UAAS,uBAA4B,KACnC,OAAO,CAAC,YAAY,CAIpB,CAAA"}

package/dist/environments.js

@@ -4,6 +4,7 @@
  * Wire shape sourced from `@sylphx/contract` (ADR-084).
  */
 import { environmentsEndpoints } from '@sylphx/contract';
+import { ApiError } from './errors.js';
 import { interpolatePath, request } from './http.js';
 const orgHeaders = (options = {}) => ({
     ...(options.orgId ? { 'x-preferred-org-id': options.orgId } : {}),
@@ -24,11 +25,17 @@ export const resolveId = async (client, projectId, envType, options = {}) => {
     const byId = envs.find((e) => e.id === envType.trim());
     if (byId)
         return byId.id;
-    const byName = envs.find((e) => (e.name ?? '').toLowerCase() === needle);
-    if (byName)
-        return byName.id;
-    const byType = envs.find((e) => (e.envType ?? '').toLowerCase() === needle);
-    return byType?.id ?? null;
+    const byName = envs.filter((e) => (e.name ?? '').toLowerCase() === needle);
+    if (byName.length > 1) {
+        throw new ApiError(422, `Multiple active environments named '${envType}' exist for project '${projectId}'. Pass the environment id explicitly.`);
+    }
+    if (byName[0])
+        return byName[0].id;
+    const byType = envs.filter((e) => (e.envType ?? '').toLowerCase() === needle);
+    if (byType.length > 1) {
+        throw new ApiError(422, `Multiple active ${envType} environments exist for project '${projectId}'. Pass the environment id explicitly.`);
+    }
+    return byType[0]?.id ?? null;
 };
 export const promote = (client, projectId, targetEnvId, sourceEnvId, options = {}) => {
     const { method, path } = environmentsEndpoints.promote;

package/dist/logs.d.ts

@@ -17,6 +17,6 @@ export interface ListLogsOptions {
     readonly limit?: number;
     readonly orgId?: string;
 }
-export declare const stream: (client: Client, projectId: string, envType: string) => LogStream;
+export declare const stream: (client: Client, projectId: string, envType: string, options?: Pick<ListLogsOptions, "envId">) => LogStream;
 export declare const list: (client: Client, projectId: string, options?: ListLogsOptions) => Promise<LogListResult>;
 //# sourceMappingURL=logs.d.ts.map

package/dist/logs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE1D,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAQD,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,WAAW,MAAM,EAAE,SAAS,MAAM,KAAG,SAM3E,CAAA;AAED,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAS,eAAoB,KAC3B,OAAO,CAAC,aAAa,CASrB,CAAA"}
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../src/logs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE1D,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAQD,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,UAAS,IAAI,CAAC,eAAe,EAAE,OAAO,CAAM,KAC1C,SAWF,CAAA;AAED,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAS,eAAoB,KAC3B,OAAO,CAAC,aAAa,CASrB,CAAA"}

package/dist/logs.js

@@ -12,8 +12,14 @@ import { request } from './http.js';
 const orgHeaders = (options = {}) => ({
     ...(options.orgId ? { 'x-preferred-org-id': options.orgId } : {}),
 });
-export const stream = (client, projectId, envType) => {
-    const params = new URLSearchParams({ envType, stream: 'true', limit: '200' });
+export const stream = (client, projectId, envType, options = {}) => {
+    const params = new URLSearchParams({ stream: 'true', limit: '200' });
+    if (options.envId) {
+        params.set('envId', options.envId);
+    }
+    else {
+        params.set('envType', envType);
+    }
     return {
         url: `${client.apiBase}/projects/${encodeURIComponent(projectId)}/logs?${params.toString()}`,
         token: client.token,

package/dist/services.d.ts

@@ -4,6 +4,9 @@ import type { DeployResult, Service } from './types.js';
 export interface OrgScopedRequestOptions {
     readonly orgId?: string;
 }
+export interface ServiceDeployOptions extends OrgScopedRequestOptions {
+    readonly envId?: string;
+}
 export interface ServiceUpdateInput {
     readonly githubRepo?: string | null;
     readonly githubBranch?: string | null;
@@ -18,7 +21,7 @@ export declare const list: (client: Client, projectId: string, options?: OrgScop
 export declare const get: (client: Client, projectId: string, name: string, options?: OrgScopedRequestOptions) => Promise<Service>;
 export declare const update: (client: Client, projectId: string, name: string, input: ServiceUpdateInput, options?: OrgScopedRequestOptions) => Promise<Service>;
 /** Deploy a specific service — resolves envType → environmentId first. */
-export declare const deploy: (client: Client, projectId: string, name: string, envType: string, options?: OrgScopedRequestOptions) => Promise<DeployResult>;
+export declare const deploy: (client: Client, projectId: string, name: string, envType: string, options?: ServiceDeployOptions) => Promise<DeployResult>;
 declare const _delete: (client: Client, projectId: string, name: string, options?: OrgScopedRequestOptions) => Promise<void>;
 export { _delete as delete };
 //# sourceMappingURL=services.d.ts.map

package/dist/services.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../src/services.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEvD,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAS,uBAA4B,KACnC,OAAO,CAAC,OAAO,EAAE,CAQnB,CAAA;AAED,eAAO,MAAM,GAAG,GACf,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,MAAM,MAAM,EACZ,UAAS,uBAA4B,KACnC,OAAO,CAAC,OAAO,CAMhB,CAAA;AAEF,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,MAAM,MAAM,EACZ,OAAO,kBAAkB,EACzB,UAAS,uBAA4B,KACnC,OAAO,CAAC,OAAO,CAShB,CAAA;AAEF,0EAA0E;AAC1E,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,MAAM,MAAM,EACZ,SAAS,MAAM,EACf,UAAS,uBAA4B,KACnC,OAAO,CAAC,YAAY,CAWtB,CAAA;AAED,QAAA,MAAM,OAAO,GACZ,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,MAAM,MAAM,EACZ,UAAS,uBAA4B,KACnC,OAAO,CAAC,IAAI,CAMb,CAAA;AACF,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,CAAA"}
+{"version":3,"file":"services.d.ts","sourceRoot":"","sources":["../src/services.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAIzC,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEvD,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,oBAAqB,SAAQ,uBAAuB;IACpE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAS,uBAA4B,KACnC,OAAO,CAAC,OAAO,EAAE,CAQnB,CAAA;AAED,eAAO,MAAM,GAAG,GACf,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,MAAM,MAAM,EACZ,UAAS,uBAA4B,KACnC,OAAO,CAAC,OAAO,CAMhB,CAAA;AAEF,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,MAAM,MAAM,EACZ,OAAO,kBAAkB,EACzB,UAAS,uBAA4B,KACnC,OAAO,CAAC,OAAO,CAShB,CAAA;AAEF,0EAA0E;AAC1E,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,MAAM,MAAM,EACZ,SAAS,MAAM,EACf,UAAS,oBAAyB,KAChC,OAAO,CAAC,YAAY,CActB,CAAA;AAED,QAAA,MAAM,OAAO,GACZ,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,MAAM,MAAM,EACZ,UAAS,uBAA4B,KACnC,OAAO,CAAC,IAAI,CAMb,CAAA;AACF,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,CAAA"}

package/dist/services.js

@@ -1,5 +1,6 @@
 /** Per-project services — list / get / update / deploy / delete. */
 import { resolveId as resolveEnvId } from './environments.js';
+import { ApiError } from './errors.js';
 import { request } from './http.js';
 export const list = async (client, projectId, options = {}) => {
     const res = await request(client, 'GET', `/projects/${encodeURIComponent(projectId)}/services`, { headers: { 'x-preferred-org-id': options.orgId } });
@@ -12,9 +13,12 @@ export const update = (client, projectId, name, input, options = {}) => request(
 });
 /** Deploy a specific service — resolves envType → environmentId first. */
 export const deploy = async (client, projectId, name, envType, options = {}) => {
-    const environmentId = await resolveEnvId(client, projectId, envType, options);
+    const environmentId = options.envId ?? (await resolveEnvId(client, projectId, envType, options));
+    if (!environmentId) {
+        throw new ApiError(404, `Environment '${envType}' not found`);
+    }
     return request(client, 'POST', `/projects/${encodeURIComponent(projectId)}/services/${encodeURIComponent(name)}/deploy`, {
-        body: environmentId ? { environmentId } : {},
+        body: { environmentId },
         headers: { 'x-preferred-org-id': options.orgId },
     });
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@sylphx/management",
-	"version": "0.5.0",
+	"version": "0.6.0",
 	"description": "Sylphx Management SDK — pure-FP Promise client for the Sylphx Platform Management API. 55+ namespaces covering the full PaaS surface (ADR-089 Phase 4b 100% coverage), types derived from @sylphx/contract (Effect Schema SSOT).",
 	"type": "module",
 	"sideEffects": false,
@@ -205,7 +205,7 @@
 		"prepublishOnly": "bun run build"
 	},
 	"dependencies": {
-		"@sylphx/contract": "0.7.0"
+		"@sylphx/contract": "0.8.0"
 	},
 	"files": [
 		"dist",