@geekmidas/cloud 10.0.0-alpha.99 → 10.0.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.
Files changed (74) hide show
  1. package/README.md +6 -14
  2. package/dist/index-ByEJy40r.d.cts +56 -0
  3. package/dist/index-ByEJy40r.d.cts.map +1 -0
  4. package/dist/index-DZ0QrJQr.d.mts +56 -0
  5. package/dist/index-DZ0QrJQr.d.mts.map +1 -0
  6. package/dist/index.cjs +3 -3
  7. package/dist/index.d.cts +1 -1
  8. package/dist/index.d.mts +1 -1
  9. package/dist/index.mjs +3 -2
  10. package/dist/utils/index.cjs +5 -106
  11. package/dist/utils/index.d.cts +2 -62
  12. package/dist/utils/index.d.mts +2 -62
  13. package/dist/utils/index.mjs +2 -78
  14. package/dist/utils-BdKG20_m.mjs +83 -0
  15. package/dist/utils-BdKG20_m.mjs.map +1 -0
  16. package/dist/utils-CtMjuIMR.cjs +129 -0
  17. package/dist/utils-CtMjuIMR.cjs.map +1 -0
  18. package/package.json +9 -47
  19. package/src/sst/{aws/Api.ts → Api.ts} +47 -19
  20. package/src/sst/{aws/Cron.ts → Cron.ts} +46 -6
  21. package/src/sst/{aws/Function.ts → Function.ts} +41 -12
  22. package/src/sst/Queue.ts +46 -0
  23. package/src/sst/{aws/Storage.ts → Storage.ts} +3 -3
  24. package/src/sst/Topic.ts +37 -0
  25. package/src/sst/__tests__/LinkedEnvironment.spec.ts +1 -4
  26. package/src/sst/__type-tests__/authorizers.type-test.ts +2 -2
  27. package/src/sst/__type-tests__/manifest.type-test.ts +77 -0
  28. package/src/sst/__type-tests__/messaging.type-test.ts +3 -3
  29. package/src/sst/__type-tests__/storage.type-test.ts +2 -2
  30. package/src/sst/index.ts +7 -67
  31. package/src/sst/naming.ts +16 -37
  32. package/src/sst/tsconfig.json +2 -2
  33. package/dist/utils/index.cjs.map +0 -1
  34. package/dist/utils/index.d.cts.map +0 -1
  35. package/dist/utils/index.d.mts.map +0 -1
  36. package/dist/utils/index.mjs.map +0 -1
  37. package/src/dokploy/Application.ts +0 -306
  38. package/src/dokploy/__tests__/Application.provider.spec.ts +0 -206
  39. package/src/dokploy/__tests__/Application.spec.ts +0 -69
  40. package/src/dokploy/index.ts +0 -18
  41. package/src/sst/__tests__/api.spec.ts +0 -185
  42. package/src/sst/__tests__/backends.spec.ts +0 -249
  43. package/src/sst/__tests__/bootstrap.spec.ts +0 -140
  44. package/src/sst/__tests__/database.spec.ts +0 -119
  45. package/src/sst/__tests__/encryption.spec.ts +0 -90
  46. package/src/sst/__tests__/fromManifest.integration.spec.ts +0 -427
  47. package/src/sst/__tests__/fromManifest.spec.ts +0 -567
  48. package/src/sst/__tests__/function.spec.ts +0 -121
  49. package/src/sst/__tests__/links.spec.ts +0 -209
  50. package/src/sst/__tests__/provides.spec.ts +0 -107
  51. package/src/sst/__tests__/ses.spec.ts +0 -93
  52. package/src/sst/__tests__/surfaces.spec.ts +0 -149
  53. package/src/sst/__type-tests__/overrides.type-test.ts +0 -152
  54. package/src/sst/aws/Cache.ts +0 -259
  55. package/src/sst/aws/Credential.ts +0 -61
  56. package/src/sst/aws/Database.ts +0 -204
  57. package/src/sst/aws/DatabaseBootstrap.ts +0 -312
  58. package/src/sst/aws/DerivedDatabase.ts +0 -117
  59. package/src/sst/aws/Email.ts +0 -181
  60. package/src/sst/aws/Encryption.ts +0 -91
  61. package/src/sst/aws/ExternalApi.ts +0 -58
  62. package/src/sst/aws/FileServer.ts +0 -82
  63. package/src/sst/aws/ObjectStorage.ts +0 -76
  64. package/src/sst/aws/Queue.ts +0 -149
  65. package/src/sst/aws/RestApiSurface.ts +0 -114
  66. package/src/sst/aws/Secret.ts +0 -76
  67. package/src/sst/aws/StaticSite.ts +0 -92
  68. package/src/sst/aws/Topic.ts +0 -68
  69. package/src/sst/aws/bootstrap/handler.ts +0 -119
  70. package/src/sst/aws/ses.ts +0 -132
  71. package/src/sst/errors.ts +0 -65
  72. package/src/sst/fromManifest.ts +0 -1116
  73. package/src/sst/overrides.ts +0 -133
  74. package/src/sst/upstash.d.ts +0 -38
@@ -1,206 +0,0 @@
1
- import { runInNewContext } from 'node:vm';
2
- import { runtime } from '@pulumi/pulumi';
3
- import { HttpResponse, http } from 'msw';
4
- import { setupServer } from 'msw/node';
5
- import { afterAll, afterEach, beforeAll, describe, expect, it } from 'vitest';
6
- import {
7
- DokployCallFailed,
8
- applicationProvider as provider,
9
- } from '../Application';
10
-
11
- /**
12
- * The provider against Dokploy's tRPC API, served by MSW: what each lifecycle
13
- * call sends, and how it reads what comes back — including "already gone".
14
- */
15
-
16
- const endpoint = 'https://dokploy.test';
17
- const inputs = {
18
- endpoint,
19
- apiToken: 'token-1',
20
- name: 'My API',
21
- projectId: 'proj-1',
22
- environmentId: 'env-1',
23
- };
24
- /** What state holds once the application exists: every later call gets it. */
25
- const outs = { ...inputs, applicationId: 'app-1', appName: 'my-api' };
26
-
27
- const server = setupServer();
28
- beforeAll(() => server.listen({ onUnhandledRequest: 'error' }));
29
- afterEach(() => server.resetHandlers());
30
- afterAll(() => server.close());
31
-
32
- /** Records the one request a call makes, and answers it. */
33
- function answer(
34
- method: 'get' | 'post',
35
- path: string,
36
- respond: () => Response,
37
- ): { request: () => Promise<{ body: unknown; headers: Headers }> } {
38
- let seen: Request | undefined;
39
- server.use(
40
- http[method](`${endpoint}/api/trpc/${path}`, ({ request }) => {
41
- seen = request.clone();
42
- return respond();
43
- }),
44
- );
45
- return {
46
- request: async () => ({
47
- body: seen && method === 'post' ? await seen.json() : undefined,
48
- headers: seen!.headers,
49
- }),
50
- };
51
- }
52
-
53
- describe('Dokploy application provider', () => {
54
- it('creates the application under the name Dokploy derives', async () => {
55
- const call = answer('post', 'application.create', () =>
56
- HttpResponse.json({ applicationId: 'app-1', appName: 'my-api' }),
57
- );
58
-
59
- const result = await provider.create!(inputs);
60
-
61
- const { body, headers } = await call.request();
62
- expect(headers.get('x-api-key')).toBe('token-1');
63
- expect(body).toEqual({
64
- name: 'My API',
65
- projectId: 'proj-1',
66
- environmentId: 'env-1',
67
- appName: 'my-api',
68
- });
69
- // Pulumi's id is Dokploy's, so state and the Dokploy UI name the same thing.
70
- expect(result).toEqual({
71
- id: 'app-1',
72
- outs: { ...inputs, applicationId: 'app-1', appName: 'my-api' },
73
- });
74
- });
75
-
76
- it('refreshes from the server, and reports one deleted by hand as gone', async () => {
77
- answer('get', 'application.one', () =>
78
- HttpResponse.json({ applicationId: 'app-1', appName: 'my-api-2' }),
79
- );
80
- expect(await provider.read!('app-1', outs)).toEqual({
81
- id: 'app-1',
82
- props: { ...inputs, applicationId: 'app-1', appName: 'my-api-2' },
83
- });
84
-
85
- server.resetHandlers();
86
- answer('get', 'application.one', () => HttpResponse.json(null));
87
- expect(await provider.read!('app-1', outs)).toEqual({ id: undefined });
88
- });
89
-
90
- it('diffs through the same rule preview uses', async () => {
91
- expect(
92
- await provider.diff!('app-1', outs, { ...inputs, name: 'Gateway' }),
93
- ).toMatchObject({ changes: true, replaces: ['name'] });
94
- });
95
-
96
- it('renames in place, and reports the app name that follows', async () => {
97
- const call = answer('post', 'application.update', () =>
98
- HttpResponse.json({}),
99
- );
100
-
101
- const result = await provider.update!('app-1', outs, {
102
- ...inputs,
103
- name: 'My Api',
104
- });
105
-
106
- expect((await call.request()).body).toEqual({
107
- applicationId: 'app-1',
108
- name: 'My Api',
109
- });
110
- expect(result).toEqual({
111
- outs: {
112
- ...inputs,
113
- name: 'My Api',
114
- applicationId: 'app-1',
115
- appName: 'my-api',
116
- },
117
- });
118
- });
119
-
120
- it('treats an application that is already gone as deleted', async () => {
121
- const call = answer('post', 'application.remove', () =>
122
- HttpResponse.text('no such application', {
123
- status: 404,
124
- statusText: 'Not Found',
125
- }),
126
- );
127
-
128
- await expect(provider.delete!('app-1', outs)).resolves.toBeUndefined();
129
- expect((await call.request()).body).toEqual({ applicationId: 'app-1' });
130
- });
131
-
132
- it('fails a delete, or any call, that Dokploy refused for another reason', async () => {
133
- answer('post', 'application.remove', () =>
134
- HttpResponse.text('database is locked', {
135
- status: 500,
136
- statusText: 'Internal Server Error',
137
- }),
138
- );
139
- await expect(provider.delete!('app-1', outs)).rejects.toThrow(
140
- DokployCallFailed,
141
- );
142
- await expect(provider.delete!('app-1', outs)).rejects.toMatchObject({
143
- path: 'application.remove',
144
- status: 500,
145
- detail: 'database is locked',
146
- });
147
-
148
- server.resetHandlers();
149
- answer(
150
- 'post',
151
- 'application.create',
152
- () => new HttpResponse(null, { status: 401, statusText: 'Unauthorized' }),
153
- );
154
- await expect(provider.create!(inputs)).rejects.toMatchObject({
155
- name: 'DokployCallFailed',
156
- status: 401,
157
- });
158
- });
159
-
160
- /**
161
- * What actually runs: Pulumi serialises the provider into state and the
162
- * deploy runs that text, not this module. Serialisation rewrites
163
- * `DokployCallFailed` into a plain function that drops `Error.prototype` and
164
- * never initialises `message` — which the provider host reports — so this
165
- * runs the serialised provider and checks the error still says something.
166
- */
167
- it('still recognises a 404, and reports a failure, once serialised', async () => {
168
- const serialised = await runtime.serializeFunction(() => provider, {
169
- isFactoryFunction: true,
170
- });
171
- const module = { exports: {} as Record<string, typeof provider> };
172
- runInNewContext(serialised.text, {
173
- module,
174
- exports: module.exports,
175
- require,
176
- global: globalThis,
177
- fetch: (...args: Parameters<typeof fetch>) => fetch(...args),
178
- Error,
179
- });
180
- const deployed = module.exports[serialised.exportName]!;
181
-
182
- answer('post', 'application.remove', () =>
183
- HttpResponse.json({}, { status: 404, statusText: 'Not Found' }),
184
- );
185
- await expect(deployed.delete!('app-1', outs)).resolves.toBeUndefined();
186
-
187
- server.resetHandlers();
188
- answer('post', 'application.remove', () =>
189
- HttpResponse.text('database is locked', {
190
- status: 500,
191
- statusText: 'Internal Server Error',
192
- }),
193
- );
194
- const failure = await deployed.delete!('app-1', outs).catch(
195
- (error: unknown) => error as Error & { status: number },
196
- );
197
- expect(failure).toMatchObject({ name: 'DokployCallFailed', status: 500 });
198
- expect(failure?.message).toContain(
199
- 'Dokploy application.remove failed: 500 Internal Server Error — database is locked',
200
- );
201
- expect(failure?.stack).toBeTruthy();
202
- expect(`${failure}`).toMatch(
203
- /^DokployCallFailed: Dokploy application\.remove failed/,
204
- );
205
- });
206
- });
@@ -1,69 +0,0 @@
1
- import { describe, expect, it } from 'vitest';
2
- import { appNameFor, diffApplication } from '../Application';
3
-
4
- /**
5
- * The decisions, without a Dokploy server. Instantiating the resource needs
6
- * Pulumi and a real endpoint; deciding what a change *costs* does not, which is
7
- * the half worth asserting — a wrong answer here is a destroy nobody previewed.
8
- */
9
-
10
- const base = {
11
- name: 'Api',
12
- projectId: 'proj-1',
13
- environmentId: 'env-1',
14
- };
15
-
16
- describe('appNameFor', () => {
17
- it('is what Dokploy will actually call it', () => {
18
- expect(appNameFor('My API')).toBe('my-api');
19
- });
20
-
21
- it('collapses anything that is not a name character', () => {
22
- expect(appNameFor('Orders_v2!')).toBe('orders-v2-');
23
- });
24
- });
25
-
26
- describe('diffApplication', () => {
27
- it('sees no change when nothing changed', () => {
28
- expect(diffApplication(base, base)).toMatchObject({
29
- changes: false,
30
- replaces: [],
31
- });
32
- });
33
-
34
- it('replaces on a renamed application, because appName derives from it', () => {
35
- // Dokploy computes `appName` from the name, so changing it is a different
36
- // application rather than an edit to this one.
37
- expect(diffApplication(base, { ...base, name: 'Gateway' })).toMatchObject({
38
- changes: true,
39
- replaces: ['name'],
40
- });
41
- });
42
-
43
- it('does not replace when only the casing changed', () => {
44
- // `Api` and `API` are the same `appName`, so there is nothing to destroy —
45
- // and destroying an application to restyle its name in the UI would be a
46
- // spectacular way to lose one.
47
- expect(diffApplication(base, { ...base, name: 'API' })).toMatchObject({
48
- replaces: [],
49
- changes: true,
50
- });
51
- });
52
-
53
- it('replaces on a move between projects or environments', () => {
54
- expect(
55
- diffApplication(base, { ...base, projectId: 'proj-2' }).replaces,
56
- ).toEqual(['projectId']);
57
- expect(
58
- diffApplication(base, { ...base, environmentId: 'env-2' }).replaces,
59
- ).toEqual(['environmentId']);
60
- });
61
-
62
- it('creates the replacement before removing the old one', () => {
63
- // A Dokploy project can hold both for a moment; it cannot hold a gap
64
- // where the application used to be.
65
- expect(
66
- diffApplication(base, { ...base, name: 'Gateway' }).deleteBeforeReplace,
67
- ).toBe(false);
68
- });
69
- });
@@ -1,18 +0,0 @@
1
- /**
2
- * Dokploy as Pulumi resources — a prototype.
3
- *
4
- * The question it exists to answer: is wrapping Dokploy's REST API in a dynamic
5
- * provider worth doing for the rest of the resources? If it is, `deploy/state.ts`
6
- * and `SSMStateProvider` stop being necessary — remembering what you created is
7
- * the whole job of a state file — and `--target=server` becomes another
8
- * provisioner table rather than a deployment engine written by hand.
9
- *
10
- * One resource so far, and nothing has run against a real server.
11
- */
12
-
13
- export {
14
- Application,
15
- type ApplicationArgs,
16
- appNameFor,
17
- diffApplication,
18
- } from './Application';
@@ -1,185 +0,0 @@
1
- import { describe, expect, it } from 'vitest';
2
- import { App } from '../App';
3
- import { Api, RoutesMissingEnvironment } from '../aws/Api';
4
- import { type GkmLinkable, ResourceType } from '../Linkable';
5
-
6
- /**
7
- * The HTTP API as data: what it asks SST to route, with which authorizer, and
8
- * which links each route gets. SST's `ApiGatewayV2` is a recording stub
9
- * (`test/sst-globals.ts`), so no resource is created.
10
- */
11
-
12
- const stack = new App({
13
- name: 'shop',
14
- stage: 'prod',
15
- domain: 'shop.test',
16
- hostedZoneId: 'Z1',
17
- region: 'eu-west-1',
18
- }).stack('api');
19
-
20
- const db: GkmLinkable = { _id: 'db', _type: ResourceType.Postgres };
21
-
22
- type Recorded = {
23
- args: Record<string, unknown>;
24
- routes: { key: string; handler: Record<string, unknown>; args: unknown }[];
25
- authorizers: Record<string, unknown>[];
26
- };
27
- const recorded = (api: Api) => api as unknown as Recorded;
28
-
29
- describe('Api', () => {
30
- it('routes each entry to its handler, with only the links it needs', () => {
31
- const api = new Api(stack, 'Http', {
32
- root: 'apps/api',
33
- links: [db],
34
- environment: { FEATURE: 'on' },
35
- cors: { allowOrigins: ['https://shop.test'] },
36
- routes: [
37
- {
38
- method: 'GET',
39
- path: '/orders',
40
- handler: 'handlers/orders.handler',
41
- environment: ['DB_URL', 'FEATURE'],
42
- },
43
- {
44
- method: 'GET',
45
- path: '/health',
46
- handler: 'handlers/health.handler',
47
- runtime: 'nodejs22.x',
48
- timeout: '5 seconds',
49
- memory: '256 MB',
50
- },
51
- ],
52
- });
53
- const { args, routes } = recorded(api);
54
-
55
- expect(api._type).toBe(ResourceType.ApiGatewayV2);
56
- // Native args pass straight through.
57
- expect(args).toEqual({ cors: { allowOrigins: ['https://shop.test'] } });
58
- expect(routes.map((r) => r.key)).toEqual(['GET /orders', 'GET /health']);
59
-
60
- const [orders, health] = routes;
61
- expect(orders!.handler).toMatchObject({
62
- handler: 'apps/api/handlers/orders.handler',
63
- runtime: 'nodejs24.x',
64
- link: [db],
65
- environment: expect.objectContaining({ STAGE: 'prod', FEATURE: 'on' }),
66
- });
67
- expect(orders!.args).toBeUndefined();
68
- // Least privilege: a route that names no link var gets no link.
69
- expect(health!.handler).toMatchObject({
70
- link: [],
71
- runtime: 'nodejs22.x',
72
- timeout: '5 seconds',
73
- memory: '256 MB',
74
- });
75
- });
76
-
77
- it('wires each route to the authorizer it names', () => {
78
- const lambda = { arn: 'arn:aws:lambda:eu-west-1:1:function:authz' };
79
- const api = new Api(stack, 'Http', {
80
- authorizers: {
81
- jwt: {
82
- issuer: 'https://id.shop.test',
83
- audiences: ['shop'],
84
- scopes: ['read'],
85
- },
86
- tenant: { handler: lambda as never, payload: '2.0' },
87
- key: { handler: 'handlers/key.handler' },
88
- },
89
- routes: [
90
- { method: 'GET', path: '/a', handler: 'a.h', authorizer: 'jwt' },
91
- {
92
- method: 'GET',
93
- path: '/b',
94
- handler: 'b.h',
95
- authorizer: 'jwt',
96
- scopes: ['write'],
97
- },
98
- { method: 'GET', path: '/c', handler: 'c.h', authorizer: 'tenant' },
99
- { method: 'GET', path: '/d', handler: 'd.h', authorizer: 'iam' },
100
- { method: 'GET', path: '/e', handler: 'e.h', authorizer: 'none' },
101
- { method: 'GET', path: '/f', handler: 'f.h' },
102
- ],
103
- } as never);
104
- const { routes, authorizers } = recorded(api);
105
-
106
- expect(authorizers).toEqual([
107
- {
108
- name: 'jwt',
109
- jwt: {
110
- issuer: 'https://id.shop.test',
111
- audiences: ['shop'],
112
- identitySource: undefined,
113
- },
114
- },
115
- {
116
- name: 'tenant',
117
- // A `Function` construct is passed as its ARN.
118
- lambda: {
119
- function: lambda.arn,
120
- identitySources: undefined,
121
- payload: '2.0',
122
- },
123
- },
124
- {
125
- name: 'key',
126
- lambda: {
127
- function: 'handlers/key.handler',
128
- identitySources: undefined,
129
- payload: undefined,
130
- },
131
- },
132
- ]);
133
- expect(routes.map((r) => r.args)).toEqual([
134
- { auth: { jwt: { authorizer: 'jwt-authorizer-id', scopes: ['read'] } } },
135
- // A route's own scopes override the authorizer's defaults.
136
- { auth: { jwt: { authorizer: 'jwt-authorizer-id', scopes: ['write'] } } },
137
- { auth: { lambda: 'tenant-authorizer-id' } },
138
- { auth: { iam: true } },
139
- undefined,
140
- undefined,
141
- ]);
142
- });
143
-
144
- it('fails the synth, naming every route whose variables no link provides', () => {
145
- const build = () =>
146
- new Api(stack, 'Http', {
147
- links: [db],
148
- routes: [
149
- {
150
- method: 'GET',
151
- path: '/ok',
152
- handler: 'ok.h',
153
- environment: ['DB_URL'],
154
- },
155
- {
156
- method: 'POST',
157
- path: '/pay',
158
- handler: 'pay.h',
159
- environment: ['STRIPE_KEY'],
160
- },
161
- {
162
- method: 'GET',
163
- path: '/mail',
164
- handler: 'mail.h',
165
- environment: ['SMTP_URL'],
166
- },
167
- ],
168
- });
169
-
170
- expect(build).toThrow(RoutesMissingEnvironment);
171
- expect(build).toThrow(/Http POST \/pay[\s\S]*STRIPE_KEY/);
172
- expect(build).toThrow(/Http GET \/mail[\s\S]*SMTP_URL/);
173
- });
174
-
175
- it('leaves a route public rather than half-wired when its authorizer was never declared', () => {
176
- const api = new Api(stack, 'Http', {
177
- routes: [
178
- { method: 'GET', path: '/ghost', handler: 'g.h', authorizer: 'ghost' },
179
- ],
180
- } as never);
181
-
182
- expect(recorded(api).routes[0]!.args).toBeUndefined();
183
- expect(recorded(api).authorizers).toEqual([]);
184
- });
185
- });