@cognite/cli 1.9.0-alpha.2 → 1.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -0
- package/_templates/agents/create/EVAL_CASES_TEMPLATE.yaml +4 -0
- package/_templates/agents/create/README_TEMPLATE.md +2 -2
- package/_templates/app/new/root/package.json.ejs.t +4 -4
- package/_templates/app/new/src/App.test.tsx.ejs.t +27 -26
- package/_templates/app/new/src/App.tsx.ejs.t +6 -3
- package/dist/{chunk-P2OHSI4O.js → chunk-IYQSEWZ2.js} +6 -6
- package/dist/cli/cli.js +102 -142
- package/dist/deploy/index.js +1 -1
- package/dist/index.js +1 -1
- package/package.json +3 -4
package/README.md
CHANGED
|
@@ -12,6 +12,10 @@ npx @cognite/cli apps create
|
|
|
12
12
|
|
|
13
13
|
This prompts for your app name, org, project, and cluster, then generates a fully configured React + TypeScript project.
|
|
14
14
|
|
|
15
|
+
## Feature Flags
|
|
16
|
+
|
|
17
|
+
Set environment variable `COGNITE_ALPHA_ENABLE_SESSION_AUTH` to true in order to enable session authentication enabling auth login and logout commands which will let you skip browser login by securely persisting access tokens on your machine.
|
|
18
|
+
|
|
15
19
|
## Authentication
|
|
16
20
|
|
|
17
21
|
New apps created with `npx @cognite/cli apps create` depend on [`@cognite/app-sdk`](https://www.npmjs.com/package/@cognite/app-sdk) — **not `@cognite/cli`** — for auth and host integration. `@cognite/cli` is the CLI used to scaffold, develop, and deploy the app; the generated app itself talks to the Fusion app host via `@cognite/app-sdk`'s Comlink handshake. The template wires this up for you.
|
|
@@ -140,6 +144,7 @@ MOCK_SCENARIO=403 pnpm mock:server
|
|
|
140
144
|
| `republish` | `ensureApp` recovers (409), then `uploadVersion` fails (409 — version already published) |
|
|
141
145
|
|
|
142
146
|
The mock server and MSW handlers live in `cli/testing/msw/`. The same handlers are used by the Vitest integration tests in `src/deploy/apphosting-deployer.msw.test.ts`.
|
|
147
|
+
|
|
143
148
|
## Maintenance
|
|
144
149
|
|
|
145
150
|
### Updating the spec-kit vendor snapshot
|
|
@@ -23,6 +23,10 @@
|
|
|
23
23
|
# These are placeholders — edit the inputs, references, and context to match what
|
|
24
24
|
# your agent actually does, then add more cases over time.
|
|
25
25
|
|
|
26
|
+
# To split cases across multiple files as your suite grows, add:
|
|
27
|
+
# include:
|
|
28
|
+
# - cases/maintenance.yaml
|
|
29
|
+
|
|
26
30
|
cases:
|
|
27
31
|
# Single-turn case scored for correctness.
|
|
28
32
|
- id: greeting
|
|
@@ -20,12 +20,12 @@ cognite agents publish
|
|
|
20
20
|
| Path | Purpose |
|
|
21
21
|
|------|---------|
|
|
22
22
|
| `agent.yaml` | Agent definition (externalId, tools, model, instructions) |
|
|
23
|
-
| `eval/
|
|
23
|
+
| `eval/eval.yaml` | Example eval cases — run with `cognite agents eval` |
|
|
24
24
|
| `README.md` | This file |
|
|
25
25
|
|
|
26
26
|
## Evaluating the agent
|
|
27
27
|
|
|
28
|
-
`eval/
|
|
28
|
+
`eval/eval.yaml` contains starter test cases (single-turn and multi-turn) that
|
|
29
29
|
grade the agent's responses with an LLM judge. After pushing the agent, run:
|
|
30
30
|
|
|
31
31
|
```bash
|
|
@@ -26,7 +26,7 @@ to: '<%= useCurrentDir ? "" : ((directoryName || name) + "/") %>package.json'
|
|
|
26
26
|
"setup-https": "npx @cognite/cli@latest apps setup-https"
|
|
27
27
|
},
|
|
28
28
|
"dependencies": {
|
|
29
|
-
"@cognite/aura": "^0.3.
|
|
29
|
+
"@cognite/aura": "^0.3.5",
|
|
30
30
|
"@cognite/sdk": "^10.10.0",
|
|
31
31
|
"@cognite/app-sdk": "^0.8.0",
|
|
32
32
|
"@tabler/icons-react": "^3.35.0",
|
|
@@ -46,8 +46,8 @@ to: '<%= useCurrentDir ? "" : ((directoryName || name) + "/") %>package.json'
|
|
|
46
46
|
"@types/react": "^18.3.1",
|
|
47
47
|
"@types/react-dom": "^18.3.1",
|
|
48
48
|
"@vitejs/plugin-react": ">=5.1.1 <6.0.0",
|
|
49
|
-
"@vitest/coverage-v8": "4.1.
|
|
50
|
-
"@vitest/ui": "4.1.
|
|
49
|
+
"@vitest/coverage-v8": "4.1.10",
|
|
50
|
+
"@vitest/ui": "4.1.10",
|
|
51
51
|
"autoprefixer": "^10.4.22",
|
|
52
52
|
"eslint": "9.39.4",
|
|
53
53
|
"eslint-plugin-import": "^2.32.0",
|
|
@@ -61,6 +61,6 @@ to: '<%= useCurrentDir ? "" : ((directoryName || name) + "/") %>package.json'
|
|
|
61
61
|
"typescript": "^5.0.0",
|
|
62
62
|
"typescript-eslint": "^8.46.4",
|
|
63
63
|
"vite": ">=7.3.5 <8.0.0",
|
|
64
|
-
"vitest": "4.1.
|
|
64
|
+
"vitest": "4.1.10"
|
|
65
65
|
}
|
|
66
66
|
}
|
|
@@ -12,33 +12,37 @@ import App from './App';
|
|
|
12
12
|
|
|
13
13
|
type AppDeps = NonNullable<ComponentProps<typeof App>['deps']>;
|
|
14
14
|
|
|
15
|
-
|
|
15
|
+
type AppApi = Pick<HostAppAPI, 'syncInternalState'>;
|
|
16
|
+
|
|
17
|
+
function makeApi(): AppApi {
|
|
16
18
|
return {
|
|
17
|
-
getProject: vi.fn<HostAppAPI['getProject']>(() => Promise.resolve('<%= project %>')),
|
|
18
|
-
getBaseUrl: vi.fn<HostAppAPI['getBaseUrl']>(() => Promise.resolve('https://cognite.test')),
|
|
19
|
-
getAccessToken: vi.fn<HostAppAPI['getAccessToken']>(() => Promise.resolve('test-token')),
|
|
20
|
-
getAppId: vi.fn<HostAppAPI['getAppId']>(() => Promise.resolve('test-app-id')),
|
|
21
19
|
syncInternalState: vi.fn<HostAppAPI['syncInternalState']>(() => Promise.resolve(true)),
|
|
22
|
-
navigateInternal: vi.fn<HostAppAPI['navigateInternal']>(() => Promise.resolve(true)),
|
|
23
|
-
navigateExternal: vi.fn<HostAppAPI['navigateExternal']>(() => Promise.resolve(true)),
|
|
24
|
-
registerAgentServer: vi.fn<HostAppAPI['registerAgentServer']>(() => Promise.resolve()),
|
|
25
|
-
unregisterAgentServer: vi.fn<HostAppAPI['unregisterAgentServer']>(() => Promise.resolve()),
|
|
26
|
-
sendAgentLayoutMode: vi.fn<HostAppAPI['sendAgentLayoutMode']>(() => Promise.resolve()),
|
|
27
|
-
sendAgentMessage: vi.fn<HostAppAPI['sendAgentMessage']>(() => Promise.resolve()),
|
|
28
|
-
sendAgentTheme: vi.fn<HostAppAPI['sendAgentTheme']>(() => Promise.resolve()),
|
|
29
20
|
};
|
|
30
21
|
}
|
|
31
22
|
|
|
32
|
-
function
|
|
23
|
+
function makeConnectedFn(api: AppApi = makeApi()) {
|
|
24
|
+
return vi.fn(() => Promise.resolve({ api }));
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
function makeDeps(): AppDeps {
|
|
33
28
|
return {
|
|
34
|
-
connectToHostApp: vi.fn<AppDeps['connectToHostApp']>(() =>
|
|
29
|
+
connectToHostApp: vi.fn<AppDeps['connectToHostApp']>(() =>
|
|
30
|
+
Promise.resolve({
|
|
31
|
+
api: {
|
|
32
|
+
getProject: vi.fn<HostAppAPI['getProject']>(() => Promise.resolve('<%= project %>')),
|
|
33
|
+
getBaseUrl: vi.fn<HostAppAPI['getBaseUrl']>(() => Promise.resolve('https://cognite.test')),
|
|
34
|
+
getAccessToken: vi.fn<HostAppAPI['getAccessToken']>(() => Promise.resolve('test-token')),
|
|
35
|
+
getAppId: vi.fn<HostAppAPI['getAppId']>(() => Promise.resolve('test-app-id')),
|
|
36
|
+
} as Partial<HostAppAPI> as HostAppAPI,
|
|
37
|
+
})
|
|
38
|
+
),
|
|
35
39
|
createClient: vi.fn<AppDeps['createClient']>((config) => new CogniteClient(config)),
|
|
36
40
|
};
|
|
37
41
|
}
|
|
38
42
|
|
|
39
|
-
function
|
|
43
|
+
function makeLoadingDeps(): AppDeps {
|
|
40
44
|
return {
|
|
41
|
-
connectToHostApp: vi.fn<AppDeps['connectToHostApp']>(() => Promise
|
|
45
|
+
connectToHostApp: vi.fn<AppDeps['connectToHostApp']>(() => new Promise<ConnectToHostAppResult>(() => undefined)),
|
|
42
46
|
createClient: vi.fn<AppDeps['createClient']>((config) => new CogniteClient(config)),
|
|
43
47
|
};
|
|
44
48
|
}
|
|
@@ -49,12 +53,12 @@ describe('App', () => {
|
|
|
49
53
|
});
|
|
50
54
|
|
|
51
55
|
it('renders loading state', () => {
|
|
52
|
-
render(<App deps={makeLoadingDeps()} />);
|
|
56
|
+
render(<App deps={makeLoadingDeps()} connectToHostApp={() => new Promise<never>(() => undefined)} />);
|
|
53
57
|
expect(screen.getByText('Loading project...')).toBeInTheDocument();
|
|
54
58
|
});
|
|
55
59
|
|
|
56
60
|
it('renders splash with deployment targets and checklist copy', async () => {
|
|
57
|
-
render(<App deps={
|
|
61
|
+
render(<App deps={makeDeps()} connectToHostApp={makeConnectedFn()} />);
|
|
58
62
|
await waitFor(() => expect(screen.getByText('Welcome to Flows custom apps')).toBeInTheDocument());
|
|
59
63
|
expect(screen.getByText('App deployment checklist')).toBeInTheDocument();
|
|
60
64
|
expect(screen.getByText('Plan')).toBeInTheDocument();
|
|
@@ -73,7 +77,7 @@ describe('App', () => {
|
|
|
73
77
|
|
|
74
78
|
it('syncs internal state when the open step changes', async () => {
|
|
75
79
|
const api = makeApi();
|
|
76
|
-
render(<App deps={
|
|
80
|
+
render(<App deps={makeDeps()} connectToHostApp={makeConnectedFn(api)} />);
|
|
77
81
|
await waitFor(() => expect(screen.getByText('App deployment checklist')).toBeInTheDocument());
|
|
78
82
|
|
|
79
83
|
await userEvent.click(screen.getByText('Explore'));
|
|
@@ -85,13 +89,10 @@ describe('App', () => {
|
|
|
85
89
|
|
|
86
90
|
it('restores the open step from initial state', async () => {
|
|
87
91
|
const api = makeApi();
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
createClient: vi.fn<AppDeps['createClient']>((config) => new CogniteClient(config)),
|
|
93
|
-
};
|
|
94
|
-
render(<App deps={deps} />);
|
|
92
|
+
render(<App
|
|
93
|
+
deps={makeDeps()}
|
|
94
|
+
connectToHostApp={() => Promise.resolve({ api, initialState: JSON.stringify({ openStep: 'Deploy' }) })}
|
|
95
|
+
/>);
|
|
95
96
|
await waitFor(() => expect(screen.getByText('App deployment checklist')).toBeInTheDocument());
|
|
96
97
|
|
|
97
98
|
await waitFor(() =>
|
|
@@ -71,6 +71,9 @@ const CHECKLIST_STEPS = [
|
|
|
71
71
|
|
|
72
72
|
type AppInternalState = { openStep: string | null };
|
|
73
73
|
|
|
74
|
+
type AppApi = Pick<HostAppAPI, 'syncInternalState'>;
|
|
75
|
+
type AppConnectResult = { api: AppApi; initialState?: string };
|
|
76
|
+
|
|
74
77
|
const loadingFallback = (
|
|
75
78
|
<main className="min-h-screen bg-muted/50 text-foreground">
|
|
76
79
|
<section className="mx-auto flex min-h-screen w-full max-w-lg flex-col justify-center p-4 sm:p-8">
|
|
@@ -100,7 +103,7 @@ const errorFallback = (
|
|
|
100
103
|
</main>
|
|
101
104
|
);
|
|
102
105
|
|
|
103
|
-
type AppContentProps = { api:
|
|
106
|
+
type AppContentProps = { api: AppApi | null; initialState?: string };
|
|
104
107
|
|
|
105
108
|
function AppContent({ api, initialState }: AppContentProps) {
|
|
106
109
|
const client = useCogniteSdk();
|
|
@@ -239,14 +242,14 @@ function AppContent({ api, initialState }: AppContentProps) {
|
|
|
239
242
|
|
|
240
243
|
type AppProps = {
|
|
241
244
|
deps?: ComponentProps<typeof CogniteSdkProvider>['deps'];
|
|
242
|
-
connectToHostApp?:
|
|
245
|
+
connectToHostApp?: () => Promise<AppConnectResult>;
|
|
243
246
|
};
|
|
244
247
|
|
|
245
248
|
function App({
|
|
246
249
|
deps,
|
|
247
250
|
connectToHostApp = deps?.connectToHostApp ?? connectToHostAppImpl,
|
|
248
251
|
}: AppProps) {
|
|
249
|
-
const [connection, setConnection] = useState<
|
|
252
|
+
const [connection, setConnection] = useState<AppConnectResult | null>(null);
|
|
250
253
|
|
|
251
254
|
useEffect(() => {
|
|
252
255
|
let cancelled = false;
|
|
@@ -1,12 +1,12 @@
|
|
|
1
|
-
var
|
|
1
|
+
var xe=Object.defineProperty;var re=n=>{throw TypeError(n)};var s=(n,e)=>xe(n,"name",{value:e,configurable:!0});var ie=(n,e,t)=>e.has(n)||re("Cannot "+t);var R=(n,e,t)=>(ie(n,e,"read from private field"),t?t.call(n):e.get(n)),se=(n,e,t)=>e.has(n)?re("Cannot add the same private member more than once"):e instanceof WeakSet?e.add(n):e.set(n,t),oe=(n,e,t,r)=>(ie(n,e,"write to private field"),r?r.call(n,t):e.set(n,t),t);import{existsSync as dt}from"fs";import{mkdir as lt,readFile as ut}from"fs/promises";import{basename as gt,dirname as ft}from"path";var H=class H extends Error{constructor(e,t={}){super(e),this.name="HintedError",t.cause!==void 0&&(this.cause=t.cause);let r=this.deriveDefaults(t);this.hint=t.hint??r.hint,this.helpUrl=t.helpUrl??r.helpUrl,this.shouldReport=t.shouldReport??!0}deriveDefaults(e){return{hint:be(e.cause)}}};s(H,"HintedError");var l=H;var ae="https://docs.cognite.com/cdf/access/",Ie="https://status.cognite.com";function Ce(n){switch(n){case 401:return{hint:"Your credentials are invalid or expired. Check your client ID and secret.",helpUrl:ae};case 403:return{hint:"You don't have the required CDF capabilities. Please contact your CDF admin.",helpUrl:ae};case 413:return{hint:"The deployment exceeds the App Hosting size limit. Reduce the build output \u2014 remove unused assets, code-split bundles, or strip source maps."};case 429:return{hint:"You are being rate limited. Wait a few moments and retry. If this persists, contact CDF support."};case 500:case 502:case 503:case 504:return{hint:"CDF service error. The issue is on the server side. Check the status page and retry shortly.",helpUrl:Ie};default:return{}}}s(Ce,"defaultHintForStatus");var M=class M extends l{constructor(e,t){super(e,t),this.name="HintedHttpError",this.httpStatusCode=t.httpStatusCode,this.requestUrl=t.requestUrl,this.responseBody=t.responseBody}deriveDefaults(e){let{httpStatusCode:t}=e,r=Ce(t),i=super.deriveDefaults(e);return{hint:r.hint??i.hint,helpUrl:r.helpUrl}}};s(M,"HintedHttpError");var k=M;function Pe(n,e){if(n)switch(n){case"ENOTFOUND":return e.hostname?`DNS lookup failed for ${e.hostname}. Check your network, VPN, or proxy settings.`:"DNS lookup failed. Check your network, VPN, or proxy settings.";case"ECONNREFUSED":return e.hostname&&e.port?`Connection refused by ${e.hostname}:${e.port}. The service may be down or the port may be wrong.`:"Connection refused. The service may be down or the port may be wrong.";case"ECONNRESET":return"Connection was reset. The server closed the connection unexpectedly; check for proxy/firewall interference and retry.";case"ETIMEDOUT":return"Connection timed out. Check your network, VPN, or proxy settings, and retry.";case"EAI_AGAIN":return"Temporary DNS failure. Retry shortly; if it persists, check your DNS configuration.";case"CERT_HAS_EXPIRED":case"UNABLE_TO_VERIFY_LEAF_SIGNATURE":case"SELF_SIGNED_CERT_IN_CHAIN":return"TLS certificate validation failed. Check system clock and CA trust store; if you use a corporate proxy, ensure its root cert is trusted.";case"EACCES":return e.path?`Permission denied: ${e.path}. Check file ownership and permissions.`:"Permission denied. Check file ownership and permissions.";case"ENOENT":return e.path?`File or directory not found: ${e.path}.`:"File or directory not found.";case"EISDIR":return e.path?`Expected a file but found a directory: ${e.path}.`:"Expected a file but found a directory.";case"ENOSPC":return"No space left on device. Free up disk space and retry.";case"EADDRINUSE":return e.port?`Port ${e.port} is already in use. Stop the process using it or pick a different port.`:"Address is already in use. Stop the conflicting process or change the port.";case"EMFILE":case"ENFILE":return"Too many open files. Close other programs or raise the file descriptor limit.";default:return}}s(Pe,"hintForErrno");function be(n){let e=n,t=new Set;for(;e!=null&&!t.has(e)&&(t.add(e),typeof e=="object");){let r=e,i=Pe(r.code,r);if(i!==void 0)return i;e=r.cause}}s(be,"hintForCause");import{inspect as Te}from"util";var j="[REDACTED]",w,D=class D{constructor(e){se(this,w);oe(this,w,e)}toString(){return j}toJSON(){return j}[Te.custom](){return j}expose(){return R(this,w)}equals(e){return R(this,w)===R(e,w)}static from(e){return new D(e)}};w=new WeakMap,s(D,"SensitiveString");var E=D;var pe="https://docs.cognite.com/cdf/access/";function g(n){return n!==null&&typeof n=="object"}s(g,"isRecord");function C(n){return n instanceof Error&&"status"in n&&typeof n.status=="number"}s(C,"isHttpError");function Re(n){switch(n){case 401:return`Your credentials are invalid or expired. Check your client ID and secret.
|
|
2
2
|
See: ${pe}`;case 403:return`You don't have the required CDF capabilities. Please contact your CDF admin.
|
|
3
3
|
See: ${pe}`;default:return}}s(Re,"httpStatusHint");function f(n){let e=n instanceof Error?n:new Error(String(n));if(!C(e))return null;let t=Re(e.status);return t?Object.assign(new Error(`${e.message}
|
|
4
|
-
${t}`),{cause:e}):null}s(f,"enrichedHttpError");function
|
|
5
|
-
`)}s(
|
|
4
|
+
${t}`),{cause:e}):null}s(f,"enrichedHttpError");function De(n){if(!g(n))return null;let e=n.missing;if(Array.isArray(e))return e;let t=n.data;if(g(t)){let r=t.error;if(g(r)&&Array.isArray(r.missing))return r.missing;if(Array.isArray(t.missing))return t.missing}return null}s(De,"findMissingArray");function $e(n,e){if(!C(n)||n.status!==400)return!1;let t=De(n);return t?t.some(r=>g(r)&&typeof r.externalId=="string"&&e.includes(r.externalId)):!1}s($e,"isMissingExternalIdError");function $(n,e){return C(n)&&n.status===404||$e(n,e)}s($,"isNotFoundError");var de=["DRAFT","PUBLISHED","DEPRECATED","ARCHIVED"],le=["ACTIVE","PREVIEW"],G=class G extends Error{constructor(e,t){super(`Version ${t} of app ${e} not found`),this.name="AppVersionNotFoundError",this.appExternalId=e,this.version=t}};s(G,"AppVersionNotFoundError");var U=G,q=class q extends Error{constructor(e){super(`App ${e} not found`),this.name="AppNotFoundError",this.appExternalId=e}};s(q,"AppNotFoundError");var N=q;function V(n,e){return n.includes(e)}s(V,"includesValue");function Ue(n){return V(de,n)}s(Ue,"isAppVersionLifecycleState");function Ne(n){return V(le,n)}s(Ne,"isAppVersionAlias");function Ve(n){return typeof n.version=="string"&&Ue(n.lifecycleState)&&typeof n.entrypoint=="string"&&typeof n.createdTime=="number"&&typeof n.createdBy=="string"&&typeof n.appExternalId=="string"&&(n.alias===void 0||Ne(n.alias))&&(n.comment===void 0||typeof n.comment=="string")}s(Ve,"isAppVersion");function ce(n){if(!g(n)){let e=JSON.stringify(n)?.slice(0,200)??String(n);throw new Error(`Invalid version response: expected object, got ${e}`)}if(!Ve(n)){let e=JSON.stringify(n).slice(0,300);throw new Error(`Invalid version response: missing or malformed fields. Got: ${e}`)}return n}s(ce,"parseAppVersion");function Fe(n){if(!g(n))throw new Error("Invalid app response: not an object");let{externalId:e,name:t,description:r}=n;if(typeof e!="string")throw new Error("Invalid app response: missing externalId");if(typeof t!="string")throw new Error("Invalid app response: missing name");if(r!=null&&typeof r!="string")throw new Error("Invalid app response: malformed description");return{externalId:e,name:t,description:typeof r=="string"?r:void 0}}s(Fe,"parseAppMetadata");var J=class J{constructor(e){this.client=e}get appsBasePath(){return`/api/v1/projects/${encodeURIComponent(this.client.project)}/apphosting/apps`}async createApp(e,t,r){try{await this.client.post(this.appsBasePath,{data:{items:[{externalId:e,name:t,description:r}]}})}catch(i){throw f(i)??i}}async updateApps(e){try{await this.client.post(`${this.appsBasePath}/update`,{data:{items:e}})}catch(t){throw f(t)??t}}async getApp(e){let t=`${this.appsBasePath}/${encodeURIComponent(e)}`;try{let r=await this.client.get(t);return Fe(r.data)}catch(r){throw $(r,[e])?new N(e):f(r)??r}}async uploadVersion(e,t,r,i,o="index.html"){console.log(`\u{1F4E4} Uploading version ${t}...`);let a=new FormData;a.append("file",new Blob([new Uint8Array(r)]),i),a.append("version",t),a.append("entryPath",o);let p=encodeURIComponent(e),c=`${this.appsBasePath}/${p}/versions`,d=await this.client.authenticate();if(!d)throw new l("Failed to authenticate for upload",{hint:"Check your credentials and try again."});let S=E.from(d),h=`${this.client.getBaseUrl()}${c}`,ee=new AbortController,Ae=setTimeout(()=>ee.abort(),300*1e3),A;try{A=await fetch(h,{method:"POST",headers:{Authorization:`Bearer ${S.expose()}`},body:a,signal:ee.signal})}catch(m){throw m instanceof Error&&m.name==="AbortError"?new l("Upload timed out after 5 minutes",{hint:"The upload took longer than 5 minutes. Try again \u2014 if it keeps timing out, check your network speed or bundle size."}):new l(`Failed to upload version to ${h}`,{cause:m,hint:"Check your network connection. Uploads can also fail behind a proxy that blocks multipart POST requests."})}finally{clearTimeout(Ae)}if(!A.ok){let m=await A.text(),v;try{v=JSON.parse(m)}catch{}let T=m;if(g(v)){let x=v.error;if(typeof x=="string")T=x;else if(g(x)){let I=x.message,ne=x.code;T=typeof I=="string"?I:ne!=null?`Unknown error (code: ${ne})`:m}else{let I=v.message;T=typeof I=="string"?I:m}}let te=A.headers.get("x-request-id"),ve=te?` | X-Request-ID: ${te}`:"",ke=g(v)?v:m;throw new k(`Upload failed: ${A.status} \u2014 ${T}${ve}`,{httpStatusCode:A.status,requestUrl:h,responseBody:ke})}console.log(`\u2705 Version ${t} uploaded`)}async getVersion(e,t){let r=encodeURIComponent(e),i=encodeURIComponent(t),o=`${this.appsBasePath}/${r}/versions/${i}`;try{let a=await this.client.get(o);return ce(a.data)}catch(a){throw $(a,[e,t])?new U(e,t):f(a)??a}}async getActiveVersion(e){let t=encodeURIComponent(e),r=`${this.appsBasePath}/${t}/versions/list`;try{let i=await this.client.post(r,{data:{filter:{aliases:["ACTIVE"]}}});if(!g(i.data)||!Array.isArray(i.data.items))throw new Error("Invalid versions/list response: expected an object with an items array");let{items:o}=i.data;if(o.length===0)return null;if(o.length>1)throw new Error(`Unexpected response: ${o.length} versions have the ACTIVE alias, expected at most 1`);return ce(o[0])}catch(i){if($(i,[e]))return null;throw f(i)??i}}async deleteVersions(e,t){let r=encodeURIComponent(e),i=`${this.appsBasePath}/${r}/versions/delete`;try{await this.client.post(i,{data:{items:t.map(o=>({version:o}))}})}catch(o){throw f(o)??o}}async updateVersions(e,t){let r=encodeURIComponent(e),i=`${this.appsBasePath}/${r}/versions/update`;try{await this.client.post(i,{data:{items:t}})}catch(o){throw f(o)??o}}async submitSignatures(e,t,r){let i=encodeURIComponent(e),o=encodeURIComponent(t),a=`${this.appsBasePath}/${i}/versions/${o}/signatures`;try{await this.client.post(a,{data:{items:r}})}catch(p){throw f(p)??p}}async listSignatures(e,t){let r=encodeURIComponent(e),i=encodeURIComponent(t),o=`${this.appsBasePath}/${r}/versions/${i}/signatures/list`;try{let a=await this.client.post(o,{data:{}});return Be(a.data)}catch(a){throw f(a)??a}}};s(J,"AppHostingApi");var F=J,Oe=["VALID","REVOKED","EXPIRED","SIGNED_BEFORE_KEY_ISSUED","IAT_IN_FUTURE","BUNDLE_TOO_OLD","KEY_NOT_IN_REGISTRY","SCOPE_MISMATCH","VERIFICATION_FAILED"],_e=["developer","certifier"];function Be(n){if(!g(n))throw new Error("Invalid signatures response: expected an object with an items array");let{items:e}=n;if(!Array.isArray(e))throw new Error("Invalid signatures response: items property is missing or not an array");return e.flatMap(t=>{let r=Le(t);return r?[r]:[]})}s(Be,"parseStoredSignatures");function Le(n){if(!g(n))return null;let{signerKid:e,signerRole:t,signatureIat:r,receivedAt:i,createdTime:o,status:a}=n;return typeof e!="string"||e===""||!V(_e,t)||typeof r!="number"||typeof i!="number"||typeof o!="number"||!V(Oe,a)?null:{signerKid:e,signerRole:t,signatureIat:r,receivedAt:i,createdTime:o,status:a}}s(Le,"parseStoredSignature");function He(n,e){let t=[];n.name!==e.name&&t.push({field:"name",remote:n.name,local:e.name});let r=n.description??"";return r!==e.description&&t.push({field:"description",remote:r,local:e.description}),t}s(He,"diffAppMetadata");function Me(n){let e=["Cannot deploy: metadata in app.json differs from what's deployed:"];for(let{field:t,remote:r,local:i}of n){let o=`${t}:`.padEnd(14);e.push(` ${o}"${r}" \u2192 "${i}"`)}return e.join(`
|
|
5
|
+
`)}s(Me,"formatMetadataDriftError");var z=class z{constructor(e){this.api=new F(e)}getVersion(e,t){return this.api.getVersion(e,t)}uploadVersion(e,t,r,i,o){return this.api.uploadVersion(e,t,r,i,o)}async ensureApp(e,t,r){console.log("\u{1F50D} Ensuring app exists...");try{await this.api.createApp(e,t,r),console.log(`\u2705 App '${e}' created`)}catch(i){if(C(i)&&i.status===409){console.log(`\u2705 App '${e}' already exists`),await this.checkMetadataDrift(e,t,r);return}throw i}}async checkMetadataDrift(e,t,r){let i;try{i=await this.getApp(e)}catch{return}let o=He(i,{name:t,description:r});if(o.length!==0)throw new l(Me(o),{hint:"Run npx @cognite/cli apps metadata update to sync before deploying",shouldReport:!1})}getApp(e){return this.api.getApp(e)}async updateAppMetadata(e,t,r){await this.api.updateApps([{externalId:e,update:{name:{set:t},description:r?{set:r}:{setNull:!0}}}])}async submitSignatures(e,t,r){r.length!==0&&(console.log(`\u{1F50F} Submitting ${r.length} signature${r.length===1?"":"s"} for version ${t}...`),await this.api.submitSignatures(e,t,r),console.log("\u2705 Signatures stored"))}listSignatures(e,t){return this.api.listSignatures(e,t)}async publishVersion(e,t){await this.api.updateVersions(e,[{version:t,update:{lifecycleState:{set:"PUBLISHED"}}}])}async publishAndActivate(e,t){console.log(`\u{1F680} Publishing and activating version ${t}...`),await this.api.updateVersions(e,[{version:t,update:{lifecycleState:{set:"PUBLISHED"},alias:{set:"ACTIVE"}}}]),console.log(`\u2705 Version ${t} is now PUBLISHED and ACTIVE`)}getActiveVersion(e){return this.api.getActiveVersion(e)}async deactivateVersion(e,t){await this.api.updateVersions(e,[{version:t,update:{alias:{setNull:!0}}}])}async deleteVersion(e,t){await this.api.deleteVersions(e,[t])}async deprecateVersion(e,t){await this.api.updateVersions(e,[{version:t,update:{lifecycleState:{set:"DEPRECATED"}}}])}async archiveVersion(e,t){await this.api.updateVersions(e,[{version:t,update:{lifecycleState:{set:"ARCHIVED"}}}])}async activateVersion(e,t){let r=null;try{r=await this.api.getActiveVersion(e)}catch{r=null}let i=r&&r.version!==t?r.version:void 0;return await this.api.updateVersions(e,[{version:t,update:{alias:{set:"ACTIVE"}}}]),{supersededVersion:i}}async deploy(e,t,r,i,o,a,p=!1){console.log(`
|
|
6
6
|
\u{1F680} Deploying application via App Hosting API...
|
|
7
7
|
`),await this.ensureApp(e,t,r),await this.uploadVersion(e,i,o,a),p&&await this.publishAndActivate(e,i),console.log(`
|
|
8
|
-
\u2705 Deployment successful!`)}};s(z,"AppHostingClient");var P=z;import{execFileSync as O}from"child_process";import y from"fs";import
|
|
9
|
-
`).filter(Boolean),i=s(a=>a.split("/").some(p=>
|
|
8
|
+
\u2705 Deployment successful!`)}};s(z,"AppHostingClient");var P=z;import{execFileSync as O}from"child_process";import y from"fs";import u from"path";import{parseAndValidateManifestConfig as qe}from"@cognite/app-sdk/vite";import{BlobReader as Je,Uint8ArrayWriter as ze,ZipWriter as Ye}from"@zip.js/zip.js";import{execFileSync as je}from"child_process";function Ge(n={}){let{execFileSync:e=je}=n;try{return e("git",["--version"],{stdio:"ignore"}),!0}catch{return!1}}s(Ge,"isGitInstalled");function ue(n={}){if(!Ge(n))throw new l("Git is not installed or not found on PATH.",{hint:"Install Git (https://git-scm.com) and ensure it is on your PATH, then try again.",shouldReport:!1})}s(ue,"throwIfGitMissing");var Y="package.json",K="package-lock.json",ge="manifest.json",W=".cognite",Ke=[/^\.env(\..+)?$/i,/^\.secrets?$/i,/^\.token/i,/^\.cognite/i,/\.(key|pem|p12|pfx|jks|crt)$/i],X=class X{constructor(e="dist"){this.distPath=u.isAbsolute(e)?e:u.join(process.cwd(),e),this.appRoot=u.dirname(this.distPath)}validateBuildDirectory(){if(!y.existsSync(this.distPath))throw new Error(`Build directory "${this.distPath}" not found. Run build first.`);let e=u.join(this.appRoot,Y);if(!y.existsSync(e))throw new Error(`"${e}" not found. It is required for deployment.`);let t=u.join(this.appRoot,K);if(!y.existsSync(t))throw new Error(`"${t}" not found. It is required for deployment.`)}async createZip(e="app.zip",t=!1){this.validateBuildDirectory(),console.log("\u{1F4E6} Packaging application...");let r=new Ye(new ze,{level:9}),i=s(async(c,d)=>{await r.add(d,new Je(await y.openAsBlob(c))),t&&console.log(` \u{1F4C4} ${d}`)},"addFile"),o=s(async c=>{let d=await y.promises.readdir(c,{withFileTypes:!0});for(let S of d){let h=u.join(c,S.name);S.isDirectory()?await o(h):await i(h,u.relative(this.distPath,h).replace(/\\/g,"/"))}},"addDir"),a;try{await o(this.distPath);let c=u.join(this.appRoot,Y);await i(c,u.posix.join(W,Y));let d=u.join(this.appRoot,ge);if(y.existsSync(d)){let h=y.readFileSync(d,"utf-8");qe(h,d),await i(d,u.posix.join(W,ge))}let S=u.join(this.appRoot,K);await i(S,u.posix.join(W,K)),a=await r.close()}catch(c){let d=c instanceof Error?c.message:String(c);throw new Error(`Failed to create zip: ${d}`)}try{await y.promises.writeFile(e,a)}catch(c){throw new l(`Failed to write bundle to ${e}`,{cause:c})}let p=(a.byteLength/1024/1024).toFixed(2);return console.log(`\u2705 App packaged: ${e} (${p} MB)`),e}async createSourceArchive(e){console.log("\u{1F4E6} Packaging source for review...");let t;try{t=O("git",["-C",this.appRoot,"rev-parse","--show-toplevel"],{encoding:"utf-8",stdio:["pipe","pipe","pipe"]}).trim()}catch(c){throw ue(),new l("Source packaging requires a git repository.",{hint:"Run `git init` first.",shouldReport:!1,cause:c})}let r=O("git",["-C",this.appRoot,"rev-parse","--show-prefix"],{encoding:"utf-8",stdio:["pipe","pipe","pipe"]}).trim(),i=r?r.replace(/\/$/,""):".",o=i==="."?"HEAD":`HEAD:${i}`;this.validateNoSensitiveFiles(t,o);try{O("git",["-C",t,"archive","--format=zip",`--output=${e}`,o])}catch(c){let d=c instanceof Error?c.message:String(c);throw new Error(`Failed to create source archive: ${d}`)}let p=(y.statSync(e).size/1024/1024).toFixed(2);return console.log(`\u2705 Source packaged: ${u.basename(e)} (${p} MB)`),e}validateNoSensitiveFiles(e,t){let r=O("git",["-C",e,"ls-tree","-r","--name-only",t],{encoding:"utf-8",stdio:["pipe","pipe","pipe"]}).trim().split(`
|
|
9
|
+
`).filter(Boolean),i=s(a=>a.split("/").some(p=>Ke.some(c=>c.test(p))),"isSensitive"),o=r.filter(i);if(o.length>0)throw new Error(`Source archive would include sensitive files \u2014 remove them from git tracking first:
|
|
10
10
|
`+o.map(a=>` ${a}`).join(`
|
|
11
11
|
`)+`
|
|
12
|
-
Hint: git rm --cached <file>`)}};s(X,"ApplicationPackager");var
|
|
12
|
+
Hint: git rm --cached <file>`)}};s(X,"ApplicationPackager");var b=X;import We from"path";var fe=".cognite-bundles";function he(n,e){return`${n}-${e}.zip`}s(he,"bundleFileName");function _(n,e,t){return We.join(n,fe,he(e,t))}s(_,"bundlePath");import{CogniteClient as ot}from"@cognite/sdk";function me(n=process.env){return n.COGNITE_ALPHA_ENABLE_SESSION_AUTH?.trim().toLowerCase()==="true"}s(me,"isSessionAuthEnabled");function Xe(n){return Math.floor(Math.random()*Math.min(2**n*250,15e3))}s(Xe,"exponentialBackoffWithJitter");function Ze(n){return new Promise(e=>setTimeout(e,n))}s(Ze,"sleep");async function ye(n,e={}){let t=e.maxAttempts??5,r=e.shouldRetry??(()=>!0),i=e.delayInMsCalculator??Xe;if(t<1)throw new Error("`maxAttempts` must be 1 or greater");if(t>100)throw new Error("`maxAttempts` must be 100 or less");let o=1;for(;;)try{return await n()}catch(a){if(o>=t||!r(a))throw a;let p=i(o);e.onAttemptFail?.(a,o,p),await Ze(p),o++}}s(ye,"retryAsync");var Qe="https://auth.cognite.com/oauth2/token",et=s(n=>typeof n=="object"&&n!==null&&"access_token"in n&&typeof n.access_token=="string","hasAccessToken");async function Se({idp:n,tokenUrl:e,init:t,missingTokenHint:r}){let i;try{i=await ye(()=>fetch(e,t),{maxAttempts:3})}catch(p){throw new l(`Failed to fetch access token from ${e}`,{cause:p})}if(!i.ok){let p=await i.text();throw new k(`Failed to get token from ${n}: ${i.status} ${i.statusText}`,{httpStatusCode:i.status,requestUrl:e,responseBody:p})}let o=await i.text(),a;try{a=JSON.parse(o)}catch{throw new l(`Unexpected response from ${n} authentication (invalid JSON)`,{hint:r})}if(!et(a))throw new l(`No access token in ${n} authentication response`,{hint:r});return E.from(a.access_token)}s(Se,"fetchOAuthToken");var tt=s(n=>{let e=n.DEPLOYMENT_SECRETS;if(!e)return{};try{let t=JSON.parse(e),r={};for(let[i,o]of Object.entries(t))if(typeof o=="string"){let a=i.toLowerCase().replace(/_/g,"-");r[a]=o}return r}catch(t){return console.error("Error parsing DEPLOYMENT_SECRETS:",t),{}}},"loadSecretsFromEnv"),nt=s((n,e)=>{let t;if(e.DEPLOYMENT_SECRET&&(t=e.DEPLOYMENT_SECRET),t||(t=tt(e)[n]),t||(t=e[n]),!t)throw new l(`Set the ${n} environment variable (named by deploySecretName in app.json) to your deploy client secret, e.g. in a .env file.`,{shouldReport:!1,hint:me(e)?"Alternatively, run `cognite auth login` to use your session, or pass --interactive for a one-off browser login.":"Alternatively, pass --interactive for a one-off browser login."});return E.from(t)},"getSecretFromEnv"),rt=s((n,e)=>{let t=e.expose();return Se({idp:"CDF",tokenUrl:Qe,init:{method:"POST",headers:{Authorization:`Basic ${btoa(`${n}:${t}`)}`,"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams({grant_type:"client_credentials"})},missingTokenHint:"Check the client ID in app.json and the deployment secret in your environment."})},"getTokenCdf"),Ee=s(({idp:n,tokenUrl:e,clientId:t,clientSecret:r,scopes:i,missingTokenHint:o})=>Se({idp:n,tokenUrl:e,init:{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams({client_id:t,client_secret:r,grant_type:"client_credentials",...i!==void 0?{scope:i.join(" ")}:{}})},missingTokenHint:o}),"getTokenWithClientCredentials"),it=s((n,e)=>{if(e!==void 0)return e.join(" ");if(!n)throw new Error("Entra ID authentication requires 'baseUrl' to be set in deployment configuration");try{return`${new URL(n).origin}/.default`}catch{throw new Error(`Entra ID authentication requires 'baseUrl' to be a valid CDF URL (e.g., https://cluster.cognitedata.com), got: ${n}`)}},"resolveEntraScope"),st=s((n,e,t,r,i)=>Ee({idp:"Entra ID",tokenUrl:`https://login.microsoftonline.com/${t}/oauth2/v2.0/token`,clientId:n,clientSecret:e.expose(),scopes:i!==void 0?i:[it(r)],missingTokenHint:"Check the client ID and tenant ID in app.json and the deployment secret in your environment."}),"getTokenEntra"),Z=s(async(n,e=process.env)=>{if(e.COGNITE_TOKEN)return E.from(e.COGNITE_TOKEN);let{deployClientId:t,deploySecretName:r,idpType:i="cdf",tenantId:o,baseUrl:a,scopes:p,tokenUrl:c}=n,d=nt(r,e);if(i==="oauth"){if(!c)throw new Error("OAuth authentication requires 'tokenUrl' in deployment configuration");return Ee({idp:"OAuth",tokenUrl:c,clientId:t,clientSecret:d.expose(),scopes:p,missingTokenHint:"Check the tokenUrl, client ID, scopes, and deployment secret in app.json and your environment."})}if(i==="entra_id"){if(!o)throw new Error("Entra ID authentication requires 'tenantId' in deployment configuration");return st(t,d,o,a,p)}return rt(t,d)},"getToken");async function B(n,e,t=process.env,r){let i=await Z(n,t),o=t.COGNITE_BASE_URL??n.baseUrl,a=(r??(p=>new ot(p)))({appId:e,project:n.project,baseUrl:o,oidcTokenProvider:s(async()=>i.expose(),"oidcTokenProvider")});return await a.authenticate(),a}s(B,"getSdk");import{existsSync as at,readFileSync as pt}from"fs";var L=[".dev.sig",".cert.sig"];function ct(n,e={}){let t=e.existsSync??at,r=e.readFileSync??((o,a)=>pt(o,a)),i=[];for(let o of L){let a=`${n}${o}`;if(!t(a))continue;let p=r(a,"utf8").trim();p.length>0&&i.push(p)}return i}s(ct,"discoverSignatures");async function we(n,e,{existsSync:t=dt,mkdir:r=lt,createZip:i=s((o,a)=>new b(o).createZip(a,!0),"createZipFn")}={}){let{externalId:o,versionTag:a}=n,p=_(e,o,a);if(t(p)){let d=L.some(S=>t(`${p}${S}`))?"A signed bundle already exists here. Re-deploying will invalidate the signing process. Bump versionTag in app.json to deploy as a new version, or delete the bundle and its .sig files then re-sign after deploying.":"Bump versionTag in app.json to deploy as a new version, or delete the existing bundle from .cognite-bundles/ to redeploy the same version.";throw new l(`Bundle already exists: ${p}`,{hint:d,shouldReport:!1})}await r(ft(p),{recursive:!0}),await i(`${e}/dist`,p)}s(we,"packageBundle");async function Q(n,e,t,r,{readFile:i=ut,upload:o=s(async(a,p)=>new P(n).deploy(e.externalId,e.name,e.description,e.versionTag,a,p,r),"uploadFn")}={}){let a=_(t,e.externalId,e.versionTag),p;try{p=await i(a)}catch(c){throw new l(`Failed to read bundle file: ${a}`,{cause:c})}await o(p,gt(a))}s(Q,"uploadBundle");var ht=s(async(n,e,t)=>{let r=await B(n,t);await we(e,t),await Q(r,e,t,n.published)},"deploy"),mt=s(async(n,e,t)=>{let r=await B(n,t);await Q(r,e,t,n.published)},"deployBundle");export{P as a,b,fe as c,he as d,_ as e,Z as f,B as g,L as h,ct as i,we as j,Q as k,ht as l,mt as m};
|