@geekmidas/constructs 10.0.0-alpha.87 → 10.0.0-alpha.89

package/dist/stages-BSCF19o2.d.mts

@@ -0,0 +1,56 @@
+//#region src/stages.d.ts
+/**
+ * The project's stage names, as types.
+ *
+ * `gkm.config.ts` declares the stages — `stages: { local: 'dev', deployed:
+ * ['staging', 'prod'] }` — but constructs and application code cannot import
+ * the config, so a stage name written anywhere else was a bare `string`: a
+ * typo'd key in an `ExternalApi`'s `url` map was silently never read, and a
+ * seed's `stage === 'prodution'` branch silently never ran.
+ *
+ * `gkm dev`, `gkm build` and `gkm test --prepare` write `.gkm/stages.d.ts`,
+ * which fills this interface in from the loaded workspace:
+ *
+ * ```ts
+ * declare module '@geekmidas/constructs' {
+ *   interface Stages { local: 'dev'; deployed: 'staging' | 'prod' }
+ * }
+ * ```
+ *
+ * Until that file exists — a fresh clone, before the first run — the interface
+ * is empty and every stage type below is `string`, so nothing fails to compile
+ * for want of a generated file.
+ */
+interface Stages {}
+/** What `Stages` says under `key`, or `string` while it says nothing. */
+type Declared<TKey extends string> = Stages extends { [K in TKey]: infer TStage extends string; } ? TStage : string;
+/** The stage `gkm dev`, `exec`, `setup` and `test` run as: `stages.local`. */
+type LocalStage = Declared<'local'>;
+/** A stage `gkm deploy --stage` accepts: one of `stages.deployed`. */
+type DeployedStage = Declared<'deployed'>;
+/** What `gkm test` runs as. The CLI's own; no project stage may take it. */
+type TestStage = 'test';
+/** Any stage the project's code can find itself running as. */
+type AnyStage = LocalStage | TestStage | DeployedStage;
+/**
+ * What a seed is handed beside its database.
+ *
+ * Seeds run on every stage, production included, so a seed that should write
+ * something only somewhere — a demo tenant on the local stage, never on a
+ * deployed one — decides by the stage it is given:
+ *
+ * ```ts
+ * import type { SeedContext } from '@geekmidas/constructs';
+ *
+ * export async function seed(db: Kysely<Database>, { stage }: SeedContext) {
+ *   if (stage === 'dev') await insertDemoTenant(db);
+ * }
+ * ```
+ */
+interface SeedContext {
+  /** The stage being seeded: the local one, `test`, or a deployed one. */
+  stage: AnyStage;
+}
+//#endregion
+export { Stages as a, SeedContext as i, DeployedStage as n, TestStage as o, LocalStage as r, AnyStage as t };
+//# sourceMappingURL=stages-BSCF19o2.d.mts.map

package/dist/stages-BSCF19o2.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stages-BSCF19o2.d.mts","names":[],"sources":["../src/stages.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;UAuBiB;;KAGZ,SAAS,uBAAuB,kBACnC,KAAK,aAAa,2BAEjB;;KAIS,aAAa;;KAGb,gBAAgB;;KAGhB;;KAGA,WAAW,aAAa,YAAY;;;;;;;;;;;;;;;;UAiB/B;;EAEhB,OAAO"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/constructs",
-  "version": "10.0.0-alpha.87",
+  "version": "10.0.0-alpha.89",
   "private": false,
   "type": "module",
   "exports": {
@@ -287,13 +287,13 @@
     "lodash.uniqby": "~4.7.0",
     "openapi-types": "~12.1.3",
     "qs": "~6.16.0",
-    "@geekmidas/envkit": "^10.0.0-alpha.87",
-    "@geekmidas/events": "^10.0.0-alpha.87",
-    "@geekmidas/errors": "^10.0.0-alpha.87",
-    "@geekmidas/logger": "^10.0.0-alpha.87",
-    "@geekmidas/manifest": "^10.0.0-alpha.87",
-    "@geekmidas/schema": "^10.0.0-alpha.87",
-    "@geekmidas/services": "^10.0.0-alpha.87"
+    "@geekmidas/envkit": "^10.0.0-alpha.89",
+    "@geekmidas/errors": "^10.0.0-alpha.89",
+    "@geekmidas/events": "^10.0.0-alpha.89",
+    "@geekmidas/logger": "^10.0.0-alpha.89",
+    "@geekmidas/manifest": "^10.0.0-alpha.89",
+    "@geekmidas/schema": "^10.0.0-alpha.89",
+    "@geekmidas/services": "^10.0.0-alpha.89"
   },
   "devDependencies": {
     "@aws-sdk/client-kms": "~3.1136.0",
@@ -311,20 +311,20 @@
     "msw": "~2.15.0",
     "pg": "~8.23.0",
     "zod": "~4.6.5",
-    "@geekmidas/auth": "10.0.0-alpha.87",
-    "@geekmidas/audit": "^10.0.0-alpha.87",
-    "@geekmidas/cache": "^10.0.0-alpha.87",
-    "@geekmidas/db": "^10.0.0-alpha.87",
-    "@geekmidas/emailkit": "^10.0.0-alpha.87",
-    "@geekmidas/errors": "^10.0.0-alpha.87",
-    "@geekmidas/logger": "^10.0.0-alpha.87",
-    "@geekmidas/rate-limit": "^10.0.0-alpha.87",
-    "@geekmidas/schema": "^10.0.0-alpha.87",
-    "@geekmidas/events": "^10.0.0-alpha.87",
-    "@geekmidas/envkit": "^10.0.0-alpha.87",
-    "@geekmidas/services": "^10.0.0-alpha.87",
-    "@geekmidas/telescope": "10.0.0-alpha.87",
-    "@geekmidas/testkit": "^10.0.0-alpha.87"
+    "@geekmidas/audit": "^10.0.0-alpha.89",
+    "@geekmidas/auth": "10.0.0-alpha.89",
+    "@geekmidas/cache": "^10.0.0-alpha.89",
+    "@geekmidas/db": "^10.0.0-alpha.89",
+    "@geekmidas/emailkit": "^10.0.0-alpha.89",
+    "@geekmidas/envkit": "^10.0.0-alpha.89",
+    "@geekmidas/errors": "^10.0.0-alpha.89",
+    "@geekmidas/events": "^10.0.0-alpha.89",
+    "@geekmidas/logger": "^10.0.0-alpha.89",
+    "@geekmidas/rate-limit": "^10.0.0-alpha.89",
+    "@geekmidas/schema": "^10.0.0-alpha.89",
+    "@geekmidas/services": "^10.0.0-alpha.89",
+    "@geekmidas/telescope": "10.0.0-alpha.89",
+    "@geekmidas/testkit": "^10.0.0-alpha.89"
   },
   "peerDependencies": {
     "@aws-sdk/client-kms": ">=3.1136.0",
@@ -335,15 +335,15 @@
     "kysely": "~0.29.6",
     "msw": ">=2.15.0",
     "pg": ">=8.23.0",
-    "@geekmidas/audit": "^10.0.0-alpha.87",
-    "@geekmidas/auth": "10.0.0-alpha.87",
-    "@geekmidas/cache": "^10.0.0-alpha.87",
-    "@geekmidas/db": "^10.0.0-alpha.87",
-    "@geekmidas/emailkit": "^10.0.0-alpha.87",
-    "@geekmidas/rate-limit": "^10.0.0-alpha.87",
-    "@geekmidas/storage": "^10.0.0-alpha.87",
-    "@geekmidas/telescope": "10.0.0-alpha.87",
-    "@geekmidas/testkit": "^10.0.0-alpha.87"
+    "@geekmidas/audit": "^10.0.0-alpha.89",
+    "@geekmidas/auth": "10.0.0-alpha.89",
+    "@geekmidas/cache": "^10.0.0-alpha.89",
+    "@geekmidas/db": "^10.0.0-alpha.89",
+    "@geekmidas/emailkit": "^10.0.0-alpha.89",
+    "@geekmidas/rate-limit": "^10.0.0-alpha.89",
+    "@geekmidas/storage": "^10.0.0-alpha.89",
+    "@geekmidas/telescope": "10.0.0-alpha.89",
+    "@geekmidas/testkit": "^10.0.0-alpha.89"
   },
   "peerDependenciesMeta": {
     "@aws-sdk/client-kms": {

package/dist/external-api-BEgXYeJD.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"external-api-BEgXYeJD.d.mts","names":[],"sources":["../src/external-api.ts"],"mappings":";;;;;;KAoDK,MAAM,gBAAgB,oBAC1B,iBAAiB,YAAY;UAEb,mBAAmB,gBAAgB,kBAAkB;;;;;EAKrE,cAAc,SAAS;;EAEvB,aAAa;;EAEb,SAAS;IACR;IACA,aAAa,MAAM;QACd,UAAU,QAAQ;;cAGZ,YACZ,+BACA,gBAAgB,mBAAmB,kBACnC,8BACY,WAAW,OAAO;mBAeZ;WAXT,IAAI;WACJ,SAAS,QAAQ,aAAa,QAAQ;;mBAG9B;;UAGT;EAER,YACC,IAAI,cAAc,QACD,SAAS,mBAAmB,SAAS;;;;;;;MA0BnD,qBAAqB;EAIzB,WAAW;UAWG;;;UA6BE;EAChB,MAAM,SAAS,UAAU,WAAW,QAAQ;;;;;;cAOvC;;KAGD,cAAc,QAClB,aAAa,0BAA0B,oBACpC,iBAAiB,WAAW;;;;;;;KASpB;YACD;WACD;;WAGE;;WAEA,SAAS;;WAGT;;WAEA;;WAEA;;;;;;;;cAUC;;EAEZ,IAAI,gBAAc,SACR,cAAY;IACV,aAAa,cAAc;MACpC;;EAUH,MAAM,gBAAc,eACN;IACF;IAAc,aAAa,cAAc;MAClD;;;iBAYY,OAAO,iBAAiB,SAAS"}

package/dist/external-api-BaIgJ6Ey.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"external-api-BaIgJ6Ey.d.cts","names":[],"sources":["../src/external-api.ts"],"mappings":";;;;;;KAoDK,MAAM,gBAAgB,oBAC1B,iBAAiB,YAAY;UAEb,mBAAmB,gBAAgB,kBAAkB;;;;;EAKrE,cAAc,SAAS;;EAEvB,aAAa;;EAEb,SAAS;IACR;IACA,aAAa,MAAM;QACd,UAAU,QAAQ;;cAGZ,YACZ,+BACA,gBAAgB,mBAAmB,kBACnC,8BACY,WAAW,OAAO;mBAeZ;WAXT,IAAI;WACJ,SAAS,QAAQ,aAAa,QAAQ;;mBAG9B;;UAGT;EAER,YACC,IAAI,cAAc,QACD,SAAS,mBAAmB,SAAS;;;;;;;MA0BnD,qBAAqB;EAIzB,WAAW;UAWG;;;UA6BE;EAChB,MAAM,SAAS,UAAU,WAAW,QAAQ;;;;;;cAOvC;;KAGD,cAAc,QAClB,aAAa,0BAA0B,oBACpC,iBAAiB,WAAW;;;;;;;KASpB;YACD;WACD;;WAGE;;WAEA,SAAS;;WAGT;;WAEA;;WAEA;;;;;;;;cAUC;;EAEZ,IAAI,gBAAc,SACR,cAAY;IACV,aAAa,cAAc;MACpC;;EAUH,MAAM,gBAAc,eACN;IACF;IAAc,aAAa,cAAc;MAClD;;;iBAYY,OAAO,iBAAiB,SAAS"}