@sylphx/management 0.4.2 → 0.6.0

package/dist/refresh.d.ts

@@ -16,13 +16,15 @@
  * @see docs/adr/ADR-059-unified-credentials.md §1.1
  * @see docs/adr/ADR-089-platform-as-first-customer-of-baas.md
  */
+import { authEndpoints, type RefreshTokenResult } from '@sylphx/contract';
 import type { Client } from './client.js';
-export interface RefreshResult {
-    readonly accessToken: string;
-    readonly refreshToken: string;
-    readonly expiresIn: number;
-    readonly tokenType: 'Bearer';
-}
+export type RefreshResult = RefreshTokenResult;
+type EndpointResponse<E> = E extends {
+    readonly response: {
+        readonly Type: infer T;
+    };
+} ? T : never;
+export type SignOutResult = EndpointResponse<typeof authEndpoints.signOut>;
 /**
  * Rotate a refresh token. Returns a fresh access+refresh pair; the
  * presented refresh token is invalidated server-side (single-use
@@ -34,11 +36,8 @@ export declare const rotate: (client: Client, refreshToken: string) => Promise<R
  * revoked or unknown token still returns success to prevent side-channel
  * token-existence probing.
  */
-export declare const signOut: (client: Client, refreshToken: string) => Promise<{
-    success: boolean;
-}>;
+export declare const signOut: (client: Client, refreshToken: string) => Promise<SignOutResult>;
 /** Backwards-compat alias used by some Console flows. */
-export declare const revoke: (client: Client, refreshToken: string) => Promise<{
-    success: boolean;
-}>;
+export declare const revoke: (client: Client, refreshToken: string) => Promise<SignOutResult>;
+export {};
 //# sourceMappingURL=refresh.d.ts.map

package/dist/refresh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refresh.d.ts","sourceRoot":"","sources":["../src/refresh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAA;CAC5B;AAED;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,cAAc,MAAM,KAAG,OAAO,CAAC,aAAa,CACd,CAAA;AAErE;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,EAAE,cAAc,MAAM,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CACvB,CAAA;AAEpE,yDAAyD;AACzD,eAAO,MAAM,MAAM,WAJa,MAAM,gBAAgB,MAAM,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAI9D,CAAA"}
+{"version":3,"file":"refresh.d.ts","sourceRoot":"","sources":["../src/refresh.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACN,aAAa,EAEb,KAAK,kBAAkB,EAEvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,MAAM,aAAa,GAAG,kBAAkB,CAAA;AAC9C,KAAK,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;KAAE,CAAA;CAAE,GAAG,CAAC,GAAG,KAAK,CAAA;AAClG,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC,OAAO,aAAa,CAAC,OAAO,CAAC,CAAA;AAM1E;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,cAAc,MAAM,KAAG,OAAO,CAAC,aAAa,CAGhF,CAAA;AAEH;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,EAAE,cAAc,MAAM,KAAG,OAAO,CAAC,aAAa,CAGjF,CAAA;AAEH,yDAAyD;AACzD,eAAO,MAAM,MAAM,WANa,MAAM,gBAAgB,MAAM,KAAG,OAAO,CAAC,aAAa,CAMvD,CAAA"}

package/dist/refresh.js

@@ -16,18 +16,26 @@
  * @see docs/adr/ADR-059-unified-credentials.md §1.1
  * @see docs/adr/ADR-089-platform-as-first-customer-of-baas.md
  */
+import { authEndpoints, refreshEndpoints, } from '@sylphx/contract';
 import { request } from './http.js';
+const refreshTokenBody = (refreshToken) => ({
+    refresh_token: refreshToken,
+});
 /**
  * Rotate a refresh token. Returns a fresh access+refresh pair; the
  * presented refresh token is invalidated server-side (single-use
  * rotation per ADR-059 §1.1).
  */
-export const rotate = (client, refreshToken) => request(client, 'POST', '/auth/refresh', { body: { refreshToken } });
+export const rotate = (client, refreshToken) => request(client, refreshEndpoints.refresh.method, refreshEndpoints.refresh.path, {
+    body: refreshTokenBody(refreshToken),
+});
 /**
  * Revoke a refresh token (sign out). Idempotent — revoking an already-
  * revoked or unknown token still returns success to prevent side-channel
  * token-existence probing.
  */
-export const signOut = (client, refreshToken) => request(client, 'POST', '/auth/logout', { body: { refreshToken } });
+export const signOut = (client, refreshToken) => request(client, authEndpoints.signOut.method, authEndpoints.signOut.path, {
+    body: refreshTokenBody(refreshToken),
+});
 /** Backwards-compat alias used by some Console flows. */
 export const revoke = signOut;

package/dist/runners.d.ts

@@ -1,60 +1,9 @@
-/**
- * CI runners — self-hosted machines that execute build / deploy jobs.
- *
- *   POST   /runners                    — register (returns one-time install token)
- *   GET    /runners                    — list
- *   GET    /runners/:id/jobs           — recent jobs for a runner
- *   DELETE /runners/:id                — unregister
- *
- * The `registrationToken` returned by `register()` is shown ONCE — the
- * server only keeps a hash. Runners exchange it for a long-lived
- * credential during bootstrap.
- */
+import { type CreateRunnerInput, type CreateRunnerResult, type DeleteRunnerResult, type ListRunnerJobsResult, type ListRunnersResult, type Runner, type RunnerArch, type RunnerJob, type RunnerPlatform } from '@sylphx/contract';
 import type { Client } from './client.js';
-export type RunnerPlatform = 'linux' | 'macos' | 'windows';
-export type RunnerArch = 'x64' | 'arm64';
-export interface RunnerView {
-    readonly id: string;
-    readonly name: string;
-    readonly platform: RunnerPlatform;
-    readonly arch: RunnerArch;
-    readonly version: string | null;
-    readonly status: string;
-    readonly lastSeenAt: string | null;
-    readonly createdAt: string;
-    readonly labels?: readonly string[];
-    readonly maxJobs?: number;
-}
-export interface RunnerJob {
-    readonly id: string;
-    readonly runnerId: string | null;
-    readonly status: string;
-    readonly gitRepo: string;
-    readonly gitBranch: string;
-    readonly gitCommit: string | null;
-    readonly startedAt: string | null;
-    readonly finishedAt: string | null;
-}
-export interface RegisterInput {
-    readonly name: string;
-    readonly platform: RunnerPlatform;
-    readonly arch: RunnerArch;
-    readonly labels?: readonly string[];
-    readonly maxJobs?: number;
-}
-export interface RegisterResult {
-    readonly runnerId: string;
-    /** One-time install token — shown ONCE. */
-    readonly registrationToken: string;
-}
-export declare const register: (client: Client, input: RegisterInput) => Promise<RegisterResult>;
-export declare const list: (client: Client) => Promise<{
-    runners: readonly RunnerView[];
-}>;
-export declare const listJobs: (client: Client, runnerId: string) => Promise<{
-    jobs: readonly RunnerJob[];
-}>;
-export declare const unregister: (client: Client, runnerId: string) => Promise<{
-    success: boolean;
-}>;
+export type { CreateRunnerInput as RegisterInput, CreateRunnerResult as RegisterResult, Runner, RunnerArch, RunnerJob, RunnerPlatform, };
+export type RunnerView = Runner;
+export declare const register: (client: Client, input: CreateRunnerInput) => Promise<CreateRunnerResult>;
+export declare const list: (client: Client) => Promise<ListRunnersResult>;
+export declare const listJobs: (client: Client, runnerId: string) => Promise<ListRunnerJobsResult>;
+export declare const unregister: (client: Client, runnerId: string) => Promise<DeleteRunnerResult>;
 //# sourceMappingURL=runners.d.ts.map

package/dist/runners.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runners.d.ts","sourceRoot":"","sources":["../src/runners.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAA;AAC1D,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,CAAA;AAExC,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;CAClC;AAED,eAAO,MAAM,QAAQ,GAAI,QAAQ,MAAM,EAAE,OAAO,aAAa,KAAG,OAAO,CAAC,cAAc,CACjC,CAAA;AAErD,eAAO,MAAM,IAAI,GAAI,QAAQ,MAAM,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,CAC7C,CAAA;AAEnC,eAAO,MAAM,QAAQ,GACpB,QAAQ,MAAM,EACd,UAAU,MAAM,KACd,OAAO,CAAC;IAAE,IAAI,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,CAC+B,CAAA;AAExE,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,KAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CACpB,CAAA"}
+{"version":3,"file":"runners.d.ts","sourceRoot":"","sources":["../src/runners.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,MAAM,EACX,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EAEnB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,YAAY,EACX,iBAAiB,IAAI,aAAa,EAClC,kBAAkB,IAAI,cAAc,EACpC,MAAM,EACN,UAAU,EACV,SAAS,EACT,cAAc,GACd,CAAA;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,CAAA;AAE/B,eAAO,MAAM,QAAQ,GAAI,QAAQ,MAAM,EAAE,OAAO,iBAAiB,KAAG,OAAO,CAAC,kBAAkB,CAG7F,CAAA;AAED,eAAO,MAAM,IAAI,GAAI,QAAQ,MAAM,KAAG,OAAO,CAAC,iBAAiB,CAG9D,CAAA;AAED,eAAO,MAAM,QAAQ,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,KAAG,OAAO,CAAC,oBAAoB,CAGvF,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,EAAE,UAAU,MAAM,KAAG,OAAO,CAAC,kBAAkB,CAGvF,CAAA"}

package/dist/runners.js

@@ -1,17 +1,18 @@
-/**
- * CI runners — self-hosted machines that execute build / deploy jobs.
- *
- *   POST   /runners                    — register (returns one-time install token)
- *   GET    /runners                    — list
- *   GET    /runners/:id/jobs           — recent jobs for a runner
- *   DELETE /runners/:id                — unregister
- *
- * The `registrationToken` returned by `register()` is shown ONCE — the
- * server only keeps a hash. Runners exchange it for a long-lived
- * credential during bootstrap.
- */
-import { request } from './http.js';
-export const register = (client, input) => request(client, 'POST', '/runners', { body: input });
-export const list = (client) => request(client, 'GET', '/runners');
-export const listJobs = (client, runnerId) => request(client, 'GET', `/runners/${encodeURIComponent(runnerId)}/jobs`);
-export const unregister = (client, runnerId) => request(client, 'DELETE', `/runners/${encodeURIComponent(runnerId)}`);
+import { runnersEndpoints, } from '@sylphx/contract';
+import { interpolatePath, request } from './http.js';
+export const register = (client, input) => {
+    const { method, path } = runnersEndpoints.create;
+    return request(client, method, path, { body: input });
+};
+export const list = (client) => {
+    const { method, path } = runnersEndpoints.list;
+    return request(client, method, path);
+};
+export const listJobs = (client, runnerId) => {
+    const { method, path } = runnersEndpoints.listJobs;
+    return request(client, method, interpolatePath(path, { runnerId }));
+};
+export const unregister = (client, runnerId) => {
+    const { method, path } = runnersEndpoints.delete;
+    return request(client, method, interpolatePath(path, { runnerId }));
+};

package/dist/search.d.ts

@@ -9,54 +9,21 @@
  * query / click) remain internal. Consumers index documents through the
  * runtime SDK; this namespace is for operator-grade introspection.
  */
+import type { SearchAnalyticsResult, SearchDocumentItem, SearchListDocumentsResult, SearchNamespaceStats, SearchStatsResult, SearchTopQuery } from '@sylphx/contract';
 import type { Client } from './client.js';
-export interface TopQuery {
-    readonly query: string;
-    readonly count: number;
-}
-export interface SearchAnalytics {
-    readonly totalQueries: number;
-    readonly avgLatencyMs: number;
-    readonly clickThroughRate: number;
-    readonly topQueries: readonly TopQuery[];
-}
+export type TopQuery = SearchTopQuery;
+export type SearchAnalytics = SearchAnalyticsResult;
 export interface AnalyticsOptions {
     readonly namespace?: string;
     readonly dateFrom?: string;
     readonly dateTo?: string;
 }
 export declare const analytics: (client: Client, projectId: string, options?: AnalyticsOptions) => Promise<SearchAnalytics>;
-export interface NamespaceStats {
-    readonly namespace: string;
-    readonly count: number;
-}
-export interface SearchStats {
-    readonly totalDocuments: number;
-    readonly documentsWithEmbedding: number;
-    readonly byNamespace: readonly NamespaceStats[];
-}
+export type NamespaceStats = SearchNamespaceStats;
+export type SearchStats = SearchStatsResult;
 export declare const stats: (client: Client, projectId: string, namespace?: string) => Promise<SearchStats>;
-export interface SearchDocument {
-    readonly id: string;
-    readonly namespace: string;
-    readonly externalId: string | null;
-    readonly title: string | null;
-    readonly contentPreview: string;
-    readonly url: string | null;
-    readonly category: string | null;
-    readonly type: string | null;
-    readonly tags: readonly string[] | null;
-    readonly hasEmbedding: boolean;
-    readonly impressions: number;
-    readonly clicks: number;
-    readonly createdAt: string;
-    readonly updatedAt: string;
-}
-export interface ListDocumentsResult {
-    readonly documents: readonly SearchDocument[];
-    readonly total: number;
-    readonly hasMore: boolean;
-}
+export type SearchDocument = SearchDocumentItem;
+export type ListDocumentsResult = SearchListDocumentsResult;
 export interface ListDocumentsOptions {
     readonly namespace?: string;
     readonly limit?: number;

package/dist/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,SAAS,QAAQ,EAAE,CAAA;CACxC;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,eAAO,MAAM,SAAS,GACrB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,gBAAgB,KACxB,OAAO,CAAC,eAAe,CAOvB,CAAA;AAEH,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAA;IACvC,QAAQ,CAAC,WAAW,EAAE,SAAS,cAAc,EAAE,CAAA;CAC/C;AAED,eAAO,MAAM,KAAK,GACjB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,YAAY,MAAM,KAChB,OAAO,CAAC,WAAW,CAGnB,CAAA;AAEH,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;IACvC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,mBAAmB;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,eAAO,MAAM,aAAa,GACzB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,oBAAoB,KAC5B,OAAO,CAAC,mBAAmB,CAO3B,CAAA"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,MAAM,QAAQ,GAAG,cAAc,CAAA;AAErC,MAAM,MAAM,eAAe,GAAG,qBAAqB,CAAA;AAEnD,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,eAAO,MAAM,SAAS,GACrB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,gBAAgB,KACxB,OAAO,CAAC,eAAe,CASzB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAA;AAEjD,MAAM,MAAM,WAAW,GAAG,iBAAiB,CAAA;AAE3C,eAAO,MAAM,KAAK,GACjB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,YAAY,MAAM,KAChB,OAAO,CAAC,WAAW,CAKrB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,kBAAkB,CAAA;AAE/C,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,CAAA;AAE3D,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,eAAO,MAAM,aAAa,GACzB,QAAQ,MAAM,EACd,WAAW,MAAM,EACjB,UAAU,oBAAoB,KAC5B,OAAO,CAAC,mBAAmB,CAS7B,CAAA"}

package/dist/search.js

@@ -9,21 +9,31 @@
  * query / click) remain internal. Consumers index documents through the
  * runtime SDK; this namespace is for operator-grade introspection.
  */
-import { request } from './http.js';
-export const analytics = (client, projectId, options) => request(client, 'GET', `/search/projects/${encodeURIComponent(projectId)}/analytics`, {
-    query: {
-        namespace: options?.namespace,
-        dateFrom: options?.dateFrom,
-        dateTo: options?.dateTo,
-    },
-});
-export const stats = (client, projectId, namespace) => request(client, 'GET', `/search/projects/${encodeURIComponent(projectId)}/stats`, {
-    query: { namespace },
-});
-export const listDocuments = (client, projectId, options) => request(client, 'GET', `/search/projects/${encodeURIComponent(projectId)}/documents`, {
-    query: {
-        namespace: options?.namespace,
-        limit: options?.limit !== undefined ? String(options.limit) : undefined,
-        offset: options?.offset !== undefined ? String(options.offset) : undefined,
-    },
-});
+import { searchEndpoints } from '@sylphx/contract';
+import { interpolatePath, request } from './http.js';
+export const analytics = (client, projectId, options) => {
+    const { method, path } = searchEndpoints.getAnalytics;
+    return request(client, method, interpolatePath(path, { projectId }), {
+        query: {
+            namespace: options?.namespace,
+            dateFrom: options?.dateFrom,
+            dateTo: options?.dateTo,
+        },
+    });
+};
+export const stats = (client, projectId, namespace) => {
+    const { method, path } = searchEndpoints.getStats;
+    return request(client, method, interpolatePath(path, { projectId }), {
+        query: { namespace },
+    });
+};
+export const listDocuments = (client, projectId, options) => {
+    const { method, path } = searchEndpoints.listDocuments;
+    return request(client, method, interpolatePath(path, { projectId }), {
+        query: {
+            namespace: options?.namespace,
+            limit: options?.limit !== undefined ? String(options.limit) : undefined,
+            offset: options?.offset !== undefined ? String(options.offset) : undefined,
+        },
+    });
+};

package/dist/serviceTokens.d.ts

@@ -12,54 +12,18 @@
  * The raw token value is returned ONLY at create() and rotate() time —
  * the API stores a SHA-256 hash at rest (ADR-055 Rule A).
  */
+import type { CreateServiceTokenInput, CreateServiceTokenResult, GetServiceTokenResult, ListServiceTokensResult, RevokeServiceTokenResult, RotateServiceTokenResult, ServiceTokenView } from '@sylphx/contract';
 import type { Client } from './client.js';
-export interface ServiceTokenView {
-    readonly id: string;
-    readonly orgId: string;
-    readonly name: string;
-    readonly tokenPrefix: string | null;
-    readonly projectId: string | null;
-    readonly environmentId: string | null;
-    readonly scopes: readonly string[] | null;
-    readonly ipAllowlist: readonly string[] | null;
-    readonly createdBy: string | null;
-    readonly createdAt: string;
-    readonly expiresAt: string | null;
-    readonly lastUsedAt: string | null;
-    readonly revokedAt: string | null;
-    readonly revokedBy: string | null;
-    readonly useCount: number;
-}
+export type { ServiceTokenView };
 export interface ListOptions {
     readonly includeRevoked?: boolean;
 }
-export declare const list: (client: Client, orgId: string, options?: ListOptions) => Promise<{
-    tokens: readonly ServiceTokenView[];
-}>;
-export interface CreateInput {
-    readonly name: string;
-    readonly scopes: readonly string[];
-    readonly projectId?: string | null;
-    readonly environmentId?: string | null;
-    readonly expiresInDays?: number | null;
-    readonly ipAllowlist?: readonly string[] | null;
-}
-export interface CreateResult {
-    /** Raw bearer token — shown ONCE; the server only keeps a hash. */
-    readonly token: string;
-    readonly view: ServiceTokenView;
-}
+export declare const list: (client: Client, orgId: string, options?: ListOptions) => Promise<ListServiceTokensResult>;
+export type CreateInput = CreateServiceTokenInput;
+export type CreateResult = CreateServiceTokenResult;
 export declare const create: (client: Client, orgId: string, input: CreateInput) => Promise<CreateResult>;
-export declare const get: (client: Client, orgId: string, tokenId: string) => Promise<{
-    view: ServiceTokenView;
-}>;
-export declare const revoke: (client: Client, orgId: string, tokenId: string) => Promise<{
-    view: ServiceTokenView;
-}>;
-export interface RotateResult {
-    readonly token: string;
-    readonly oldView: ServiceTokenView;
-    readonly newView: ServiceTokenView;
-}
+export declare const get: (client: Client, orgId: string, tokenId: string) => Promise<GetServiceTokenResult>;
+export declare const revoke: (client: Client, orgId: string, tokenId: string) => Promise<RevokeServiceTokenResult>;
+export type RotateResult = RotateServiceTokenResult;
 export declare const rotate: (client: Client, orgId: string, tokenId: string) => Promise<RotateResult>;
 //# sourceMappingURL=serviceTokens.d.ts.map

package/dist/serviceTokens.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serviceTokens.d.ts","sourceRoot":"","sources":["../src/serviceTokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,MAAM,WAAW,gBAAgB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CACzB;AAED,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CACjC;AAED,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,UAAU,WAAW,KACnB,OAAO,CAAC;IAAE,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAAE,CAG/C,CAAA;AAEH,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CAC/C;AAED,MAAM,WAAW,YAAY;IAC5B,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;CAC/B;AAED,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,EAAE,OAAO,WAAW,KAAG,OAAO,CAAC,YAAY,CACD,CAAA;AAE9F,eAAO,MAAM,GAAG,GACf,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,SAAS,MAAM,KACb,OAAO,CAAC;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAKnC,CAAA;AAEF,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,SAAS,MAAM,KACb,OAAO,CAAC;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAKnC,CAAA;AAEF,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;CAClC;AAED,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,EAAE,SAAS,MAAM,KAAG,OAAO,CAAC,YAAY,CAK1F,CAAA"}
+{"version":3,"file":"serviceTokens.d.ts","sourceRoot":"","sources":["../src/serviceTokens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EACX,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EAChB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAGzC,YAAY,EAAE,gBAAgB,EAAE,CAAA;AAEhC,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;CACjC;AAED,eAAO,MAAM,IAAI,GAChB,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,UAAU,WAAW,KACnB,OAAO,CAAC,uBAAuB,CAKjC,CAAA;AAED,MAAM,MAAM,WAAW,GAAG,uBAAuB,CAAA;AAEjD,MAAM,MAAM,YAAY,GAAG,wBAAwB,CAAA;AAEnD,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,OAAO,WAAW,KAChB,OAAO,CAAC,YAAY,CAGtB,CAAA;AAED,eAAO,MAAM,GAAG,GACf,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,SAAS,MAAM,KACb,OAAO,CAAC,qBAAqB,CAG/B,CAAA;AAED,eAAO,MAAM,MAAM,GAClB,QAAQ,MAAM,EACd,OAAO,MAAM,EACb,SAAS,MAAM,KACb,OAAO,CAAC,wBAAwB,CAGlC,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,wBAAwB,CAAA;AAEnD,eAAO,MAAM,MAAM,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,EAAE,SAAS,MAAM,KAAG,OAAO,CAAC,YAAY,CAG3F,CAAA"}

package/dist/serviceTokens.js

@@ -12,11 +12,27 @@
  * The raw token value is returned ONLY at create() and rotate() time —
  * the API stores a SHA-256 hash at rest (ADR-055 Rule A).
  */
-import { request } from './http.js';
-export const list = (client, orgId, options) => request(client, 'GET', `/orgs/${encodeURIComponent(orgId)}/service-tokens`, {
-    query: { includeRevoked: options?.includeRevoked ? 'true' : undefined },
-});
-export const create = (client, orgId, input) => request(client, 'POST', `/orgs/${encodeURIComponent(orgId)}/service-tokens`, { body: input });
-export const get = (client, orgId, tokenId) => request(client, 'GET', `/orgs/${encodeURIComponent(orgId)}/service-tokens/${encodeURIComponent(tokenId)}`);
-export const revoke = (client, orgId, tokenId) => request(client, 'DELETE', `/orgs/${encodeURIComponent(orgId)}/service-tokens/${encodeURIComponent(tokenId)}`);
-export const rotate = (client, orgId, tokenId) => request(client, 'POST', `/orgs/${encodeURIComponent(orgId)}/service-tokens/${encodeURIComponent(tokenId)}/rotate`);
+import { serviceTokensEndpoints } from '@sylphx/contract';
+import { interpolatePath, request } from './http.js';
+export const list = (client, orgId, options) => {
+    const { method, path } = serviceTokensEndpoints.list;
+    return request(client, method, interpolatePath(path, { orgId }), {
+        query: { includeRevoked: options?.includeRevoked ? 'true' : undefined },
+    });
+};
+export const create = (client, orgId, input) => {
+    const { method, path } = serviceTokensEndpoints.create;
+    return request(client, method, interpolatePath(path, { orgId }), { body: input });
+};
+export const get = (client, orgId, tokenId) => {
+    const { method, path } = serviceTokensEndpoints.get;
+    return request(client, method, interpolatePath(path, { orgId, tokenId }));
+};
+export const revoke = (client, orgId, tokenId) => {
+    const { method, path } = serviceTokensEndpoints.revoke;
+    return request(client, method, interpolatePath(path, { orgId, tokenId }));
+};
+export const rotate = (client, orgId, tokenId) => {
+    const { method, path } = serviceTokensEndpoints.rotate;
+    return request(client, method, interpolatePath(path, { orgId, tokenId }));
+};

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.4.2",
+	"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.6.0"
+		"@sylphx/contract": "0.8.0"
 	},
 	"files": [
 		"dist",