@cowliss/cli 0.3.0 → 0.5.0

package/README.md

@@ -26,7 +26,7 @@ cow whoami
 ```
 
 `cow login` opens the dashboard and caches a session token. In CI, set
-`COW_DEPLOY_KEY` to a deploy key instead.
+`COW_PIPELINE_KEY` to a pipeline key instead.
 
 ## Journeys and emails as code
 
@@ -45,6 +45,7 @@ import { defineJourney } from "@cowliss/cli/journeys";
 export default defineJourney({
   trigger: { event: "checkout_started" },
   purpose: "emailMarketing",
+  senderIdentity: "cowliss-default",
   run: async (event, api) => {
     const purchased = await api.waitForEvent("purchase_completed", {
       timeout: "24h",
@@ -52,7 +53,7 @@ export default defineJourney({
     if (purchased) {
       return;
     }
-    await api.email.send({
+    await api.send.email({
       template: "abandoned-checkout",
       props: { checkoutUrl: event.properties.checkoutUrl },
     });
@@ -69,16 +70,22 @@ cow test abandoned-checkout --scenario scenarios/cart.json
 # typecheck and bundle, no API call
 cow build
 
-# publish it and make it the environment's live code
-cow deploy --env development
+# upload the project; the server compiles it
+cow push
 
-# rebuild and redeploy on every save
-cow dev
+# what the server holds, and what is on where
+cow status
+
+# turn it on, per environment
+cow enable abandoned-checkout --env development
 ```
 
-Every push creates a numbered release. `cow deploy` makes one release an
-environment's current code, `cow rollback` puts the previous one back, and a
-run that has already started stays on the release it started on.
+A push creates a new version of every journey and template whose code
+changed, and changes no flag: `cow enable` and `cow disable` are the only
+things that put code in front of anyone. A journey runs its latest version
+that finished compiling, so a push that fails to compile leaves the previous
+one running, and a run that has already started stays on the version it
+started on. To undo, `git revert` and push again.
 
 ## Admin, and everything else
 

package/dist/guest/{driver-M6LQVMr2.js → driver-14FnzM-h.js}

@@ -1,4 +1,4 @@
-import { a as manifestOutputSchema, i as journeyStepOutputSchema, o as templateRenderOutputSchema, r as guestInputSchema, t as CapabilityError } from "./journeys-BcbIxxI-.js";
+import { a as manifestOutputSchema, i as journeyStepOutputSchema, o as templateRenderOutputSchema, r as guestInputSchema, t as CapabilityError } from "./journeys-C8j8Sqvl.js";
 import { z } from "zod";
 import { createElement } from "react";
 import { renderToStaticMarkup } from "react-dom/server.browser";
@@ -78,7 +78,7 @@ function formatLogArg(value) {
 * The returned state is the driver's window into the run: the pending
 * call, the captured logs, and the clock the shims read.
 */
-function createApi(input) {
+function createApi(input, journey) {
 	let cursor = 0;
 	let markSuspended = () => {};
 	const state = {
@@ -118,17 +118,20 @@ function createApi(input) {
 					timeout: options.timeout
 				}
 			}),
-			email: { send: (args) => call({
-				name: "email.send",
-				args: {
-					template: args.template,
-					props: args.props
-				}
-			}) },
-			webhook: { send: (args) => call({
-				name: "webhook.send",
-				args
-			}) },
+			send: {
+				email: (args) => call({
+					name: "send.email",
+					args: {
+						template: args.template,
+						props: args.props,
+						senderIdentity: args.senderIdentity ?? journey.senderIdentity
+					}
+				}),
+				webhook: (args) => call({
+					name: "send.webhook",
+					args
+				})
+			},
 			traits: {
 				set: (key, value) => call({
 					name: "traits.set",
@@ -5569,7 +5572,7 @@ function readManifest(module) {
 			kind: "journey",
 			trigger: journey.trigger,
 			purpose: journey.purpose,
-			environments: journey.environments,
+			senderIdentity: journey.senderIdentity,
 			tags: journey.tags
 		});
 	}
@@ -5584,7 +5587,7 @@ function readManifest(module) {
 }
 async function runJourneyStep(module, input) {
 	const journey = asJourney(module);
-	const { api, state } = createApi(input);
+	const { api, state } = createApi(input, journey);
 	const restore = installShims({
 		clock: state.clock,
 		seed: input.seed

package/dist/guest/driver.d.ts

@@ -1,4 +1,4 @@
-import { a as ManifestOutput, i as JourneyStepOutput, o as TemplateRenderOutput } from "./index-heC1gFE_.js";
+import { a as ManifestOutput, i as JourneyStepOutput, o as TemplateRenderOutput } from "./index-BDj02EsQ.js";
 //#region src/guest/driver.d.ts
 /**
  * The in-process driver: JSON in, JSON out (spec: Guest protocol). One

package/dist/guest/driver.js

@@ -1,3 +1,3 @@
-import { t as runGuest } from "./driver-M6LQVMr2.js";
+import { t as runGuest } from "./driver-14FnzM-h.js";
 
 export { runGuest };

package/dist/guest/emails.d.ts

@@ -1,6 +1,23 @@
-import { r as SendClass } from "./constants-OZrYz4I2.js";
 import { z } from "zod";
 import { ReactElement } from "react";
+//#region ../../packages/shared/src/constants.d.ts
+/**
+ * The two classes of send, declared on the template rather than passed per
+ * call so the class cannot drift between two sends of the same message.
+ *
+ * Marketing is everything a journey sends on the org's behalf: it carries
+ * the RFC 8058 unsubscribe headers and runs the full gate list.
+ * Transactional is the developer's own operational mail (a receipt, an
+ * export-is-ready notice): it carries neither header and skips consent and
+ * the per-user frequency cap, because an unsubscribe link on an invoice is
+ * wrong and a receipt must not silently vanish for anyone who once left a
+ * newsletter. Suppression, the quota, the sending pause, and the from-domain
+ * check still apply to both: those bound cost and protect the shared SES
+ * account, and none of them are about what the recipient asked for.
+ */
+declare const SEND_CLASSES: readonly ["marketing", "transactional"];
+type SendClass = (typeof SEND_CLASSES)[number];
+//#endregion
 //#region src/guest/emails.d.ts
 /** A template's subject line, computed from the props it declares. */
 type Subject<Schema extends z.ZodType> = (props: z.infer<Schema>) => string;

package/dist/guest/{index-heC1gFE_.d.ts → index-BDj02EsQ.d.ts}

@@ -30,13 +30,14 @@ declare const journeyStepOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
       timeout: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
     }, z.core.$strict>;
   }, z.core.$strip>, z.ZodObject<{
-    name: z.ZodLiteral<"email.send">;
+    name: z.ZodLiteral<"send.email">;
     args: z.ZodObject<{
       template: z.ZodString;
       props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+      senderIdentity: z.ZodString;
     }, z.core.$strict>;
   }, z.core.$strip>, z.ZodObject<{
-    name: z.ZodLiteral<"webhook.send">;
+    name: z.ZodLiteral<"send.webhook">;
     args: z.ZodObject<{
       destination: z.ZodString;
       payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -119,13 +120,14 @@ declare const journeyStepOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         timeout: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
       }, z.core.$strict>;
     }, z.core.$strip>, z.ZodObject<{
-      name: z.ZodLiteral<"email.send">;
+      name: z.ZodLiteral<"send.email">;
       args: z.ZodObject<{
         template: z.ZodString;
         props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        senderIdentity: z.ZodString;
       }, z.core.$strict>;
     }, z.core.$strip>, z.ZodObject<{
-      name: z.ZodLiteral<"webhook.send">;
+      name: z.ZodLiteral<"send.webhook">;
       args: z.ZodObject<{
         destination: z.ZodString;
         payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -177,13 +179,14 @@ declare const journeyStepOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
         timeout: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
       }, z.core.$strict>;
     }, z.core.$strip>, z.ZodObject<{
-      name: z.ZodLiteral<"email.send">;
+      name: z.ZodLiteral<"send.email">;
       args: z.ZodObject<{
         template: z.ZodString;
         props: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        senderIdentity: z.ZodString;
       }, z.core.$strict>;
     }, z.core.$strip>, z.ZodObject<{
-      name: z.ZodLiteral<"webhook.send">;
+      name: z.ZodLiteral<"send.webhook">;
       args: z.ZodObject<{
         destination: z.ZodString;
         payload: z.ZodRecord<z.ZodString, z.ZodUnknown>;
@@ -253,14 +256,8 @@ declare const manifestOutputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
   }, z.core.$strict>, z.ZodObject<{
     segment: z.ZodString;
   }, z.core.$strict>]>;
-  purpose: z.ZodEnum<{
-    dataProcessing: "dataProcessing";
-    emailMarketing: "emailMarketing";
-  }>;
-  environments: z.ZodArray<z.ZodEnum<{
-    development: "development";
-    production: "production";
-  }>>;
+  purpose: z.ZodString;
+  senderIdentity: z.ZodOptional<z.ZodString>;
   kind: z.ZodLiteral<"journey">;
 }, z.core.$strip>, z.ZodObject<{
   tags: z.ZodPipe<z.ZodDefault<z.ZodArray<z.ZodString>>, z.ZodTransform<string[], string[]>>;
@@ -281,7 +278,7 @@ type ManifestOutput = z.infer<typeof manifestOutputSchema>;
  * reuses it.
  *
  * Both members are strict, so a journey holding the retired `source` key
- * fails to compile a release instead of silently triggering on every app.
+ * fails to compile instead of silently triggering on every app.
  * There is deliberately no pipe filter: a trigger narrows by the app the
  * write is attributed to, the same token a segment definition names.
  */