@gonovus-ai/spec-flow-cli 0.5.0 → 0.6.0

package/dist/runtime/session.js

@@ -0,0 +1,123 @@
+import createClient from "openapi-fetch";
+import { z } from "zod";
+import { parseHttpOrigin, unresolvedSpecFlowApiOrigin } from "../http-origin.js";
+import { specFlowCliUserAgent } from "../user-agent.js";
+import { writeSkillError } from "./errors.js";
+export async function selectSession(dependencies, options, serverFlag, apiKeyIdFlag) {
+    if (dependencies.environment.SPEC_FLOW_PROJECT_READ_TOKEN !== undefined) {
+        writeSkillError(dependencies, { message: "Project Read Tokens are retired; use a Workspace read-only Token", reason: "Authentication Failed", retryable: false });
+        return { exitCode: 2 };
+    }
+    const environmentCredential = dependencies.environment.SPEC_FLOW_WORKSPACE_READ_TOKEN;
+    const apiKeyEnvironment = dependencies.environment.SPEC_FLOW_API_KEY;
+    const usesApiKey = apiKeyEnvironment !== undefined || apiKeyIdFlag !== undefined;
+    if (options.requireUserSession === true && (usesApiKey || hasWorkspaceReadToken(dependencies.environment))) {
+        writeSkillError(dependencies, { message: "A User Session is required for account management", reason: "Permission Denied", retryable: false });
+        return { exitCode: 3 };
+    }
+    if ((apiKeyEnvironment !== undefined && apiKeyIdFlag !== undefined) || (usesApiKey && hasWorkspaceReadToken(dependencies.environment))) {
+        writeSkillError(dependencies, { message: "Select exactly one API Key or Workspace read-only Token credential", reason: "Invalid Operation", retryable: false });
+        return { exitCode: 2 };
+    }
+    if (apiKeyIdFlag !== undefined && !z.uuid().safeParse(apiKeyIdFlag).success) {
+        writeSkillError(dependencies, { message: "API Key ID must be a UUID", reason: "Invalid Operation", retryable: false });
+        return { exitCode: 2 };
+    }
+    if (apiKeyEnvironment !== undefined && !/^sfk_[A-Za-z0-9_-]{43}$/u.test(apiKeyEnvironment)) {
+        writeSkillError(dependencies, { message: "SPEC_FLOW_API_KEY does not contain a User API Key", reason: "Authentication Failed", retryable: false });
+        return { exitCode: 2 };
+    }
+    if (options.rejectWorkspaceReadToken === true &&
+        hasWorkspaceReadToken(dependencies.environment)) {
+        return { exitCode: rejectWorkspaceReadTokenOperation(dependencies) };
+    }
+    const baseUrl = resolveApiOrigin(dependencies, serverFlag);
+    if (baseUrl === null) {
+        return { exitCode: 2 };
+    }
+    let credential;
+    try {
+        if (apiKeyEnvironment !== undefined)
+            credential = apiKeyEnvironment;
+        else if (typeof apiKeyIdFlag === "string") {
+            if (dependencies.credentialStore.readApiKey === undefined)
+                throw new Error("API Key storage is unavailable");
+            credential = await dependencies.credentialStore.readApiKey(apiKeyIdFlag.toLowerCase());
+        }
+        else {
+            credential = environmentCredential ?? await dependencies.credentialStore.read();
+        }
+    }
+    catch {
+        writeSkillError(dependencies, {
+            message: "The CLI credential store is temporarily unavailable",
+            reason: "Temporary Failure",
+            retryable: true,
+        });
+        return { exitCode: 4 };
+    }
+    if (credential === null || credential.trim().length === 0) {
+        writeSkillError(dependencies, {
+            message: "An authenticated CLI Session, User API Key or Workspace read-only Token is required",
+            reason: "Authentication Failed",
+            retryable: false,
+        });
+        return { exitCode: 2 };
+    }
+    const configuration = {
+        baseUrl,
+        ...(usesApiKey || options.requireUserSession === true ? { redirect: "error" } : {}),
+        headers: {
+            ...(usesApiKey ? { "x-api-key": credential } : { authorization: `Bearer ${credential}` }),
+            "user-agent": specFlowCliUserAgent,
+        },
+    };
+    const client = createClient({ ...configuration,
+        fetch: options.retryTransportOnce === true
+            ? retryTransportOnce(dependencies.fetch)
+            : dependencies.fetch,
+    });
+    // Identity is a new prerequisite read, not a mutation transport retry. Both
+    // clients reuse the one already selected origin and credential.
+    const identityClient = options.retryTransportOnce === true ? createClient({ ...configuration, fetch: dependencies.fetch }) : client;
+    return { client, identityClient, credentialKind: usesApiKey ? "api-key" : hasWorkspaceReadToken(dependencies.environment) ? "workspace-read-token" : "session" };
+}
+function retryTransportOnce(fetch) {
+    return async (request) => {
+        const retryRequest = request.clone();
+        try {
+            return await fetch(request);
+        }
+        catch {
+            return fetch(retryRequest);
+        }
+    };
+}
+function resolveApiOrigin(dependencies, serverFlag) {
+    const flag = typeof serverFlag === "string" ? serverFlag : undefined;
+    const result = parseHttpOrigin(unresolvedSpecFlowApiOrigin(flag, dependencies.environment.SPEC_FLOW_API_URL));
+    if (result.valid) {
+        return result.origin;
+    }
+    writeSkillError(dependencies, {
+        message: flag === undefined
+            ? "SPEC_FLOW_API_URL must be an HTTP(S) origin without a path"
+            : "--server must be an HTTP(S) origin without a path",
+        reason: "Invalid Operation",
+        retryable: false,
+    });
+    return null;
+}
+export function rejectWorkspaceReadTokenOperation(dependencies) {
+    writeSkillError(dependencies, {
+        message: "Workspace read-only Token does not permit this operation",
+        reason: "Permission Denied",
+        retryable: false,
+    });
+    return 3;
+}
+export function hasWorkspaceReadToken(environment) {
+    const credential = environment.SPEC_FLOW_WORKSPACE_READ_TOKEN;
+    return credential !== undefined && credential.trim().length > 0;
+}
+//# sourceMappingURL=session.js.map

package/dist/runtime/session.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gonovus-ai/spec-flow-cli",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "SpecFlow supported command-line client",
   "repository": {
     "type": "git",

package/dist/work-item-time-entry-input.d.ts

@@ -1,4 +0,0 @@
-/** ISO/calendar validation ported from Kaneo time-entry/schema.ts (MIT). */
-export declare function parseTimeEntryTimestamp(value: string): string;
-export declare function parseTimeEntryUuid(value: string): string;
-export declare function parseTimeEntryDescription(value: string): string;

package/dist/work-item-time-entry-input.js

@@ -1,27 +0,0 @@
-import { z } from "zod";
-/** ISO/calendar validation ported from Kaneo time-entry/schema.ts (MIT). */
-export function parseTimeEntryTimestamp(value) {
-    const validFormat = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,9})?)?(Z|[+-]\d{2}:\d{2})$/u.test(value);
-    const year = Number(value.slice(0, 4));
-    const month = Number(value.slice(5, 7));
-    const day = Number(value.slice(8, 10));
-    const calendar = new Date(0);
-    calendar.setUTCFullYear(year, month - 1, day);
-    if (!validFormat || Number.isNaN(Date.parse(value)) || year === 0 || calendar.getUTCFullYear() !== year || calendar.getUTCMonth() !== month - 1 || calendar.getUTCDate() !== day)
-        throw new Error("Time Entry timestamp must be a valid ISO 8601 date-time with an offset");
-    const timestamp = new Date(value);
-    if (timestamp.getUTCFullYear() < 1 || timestamp.getUTCFullYear() > 9999)
-        throw new Error("Time Entry UTC year must be between 1 and 9999");
-    return timestamp.toISOString();
-}
-export function parseTimeEntryUuid(value) {
-    if (!z.uuid().safeParse(value).success)
-        throw new Error("Time Entry identifier and command key must be UUIDs");
-    return value;
-}
-export function parseTimeEntryDescription(value) {
-    if (value.length > 20_000 || value.includes("\0"))
-        throw new Error("Time Entry description exceeds the allowed limit");
-    return value;
-}
-//# sourceMappingURL=work-item-time-entry-input.js.map

package/dist/work-item-time-entry-input.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"work-item-time-entry-input.js","sourceRoot":"","sources":["../src/work-item-time-entry-input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4EAA4E;AAC5E,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,MAAM,WAAW,GAAG,0EAA0E,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3G,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,QAAQ,CAAC,cAAc,EAAE,KAAK,IAAI,IAAI,QAAQ,CAAC,WAAW,EAAE,KAAK,KAAK,GAAG,CAAC,IAAI,QAAQ,CAAC,UAAU,EAAE,KAAK,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;IAC5Q,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,SAAS,CAAC,cAAc,EAAE,GAAG,CAAC,IAAI,SAAS,CAAC,cAAc,EAAE,GAAG,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAC3I,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC;AACjC,CAAC;AACD,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAC/G,OAAO,KAAK,CAAC;AACf,CAAC;AACD,MAAM,UAAU,yBAAyB,CAAC,KAAa;IACrD,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACvH,OAAO,KAAK,CAAC;AACf,CAAC"}