ts2workflows 0.12.0 → 0.14.0

package/CHANGELOG.md

@@ -0,0 +1,125 @@
+# ts2workflows changelog
+
+## Version 0.14.0 - 2025-11-19
+
+Fixes:
+
+- Blocking calls and assignments were generated in a wrong order in complex expressions
+- Don't output undefined arguments in call steps
+- Type annotation fixes in workflowslib
+
+## Version 0.13.0 - 2025-10-12
+
+Fixes:
+
+- function identifiers (e.g. in call_step and parallel) are included in the `--link` output
+- Improve type annotations of map.\* functions
+
+## Version 0.12.0 - 2025-08-30
+
+New features:
+
+- New command line option `--link` generates self-contained YAML files (all needed subworkflows in one file)
+- Accepts Typescript's `satisfies` expression and `debugger` statement. They do not affect the YAML output.
+
+Fixes:
+
+- Empty body in an `if` statements generated invalid code
+- In certain cases nested map literals generated invalid code
+- Some expressions with many extractable sub-expressions (map literals, blocking calls) generated invalid code because a temporary variable was re-used incorrectly
+- Empty statements are accepted at the top level
+- Ignore extra arguments in blocking function calls in all cases. Previously, extra arguments were ignored in some cases but threw errors in other cases.
+- Call expressions in optional chaining (`data?.getPerson()?.name`) now result in error. Previously, they were incorrectly treated as non-optional in the generated code.
+- Fixed code generation for an object rest element nested in an array pattern: `const [{...rest}] = data`
+
+## Version 0.11.0 - 2025-06-28
+
+Breaking changes:
+
+- Requires Node 20 or newer and Typescript 5.4.0 or newer
+- retry_policy() must be called inside a try block, not after
+- Variable declarations with `var` are not supported, only `let` and `const`
+- Step name numbering starts from 1 at the start of each subworkflow
+
+Fixes:
+
+- Type annotation fixes in workflowslib
+
+## Version 0.10.0 - 2025-04-28
+
+- Accept binary expressions as properties in assignments: `a[i + 4] = 1` (regression in 0.9.0)
+- Evaluate side-effects only once on the left-hand side in compound assignments: `x[f()] += 1`
+- Fix calling `call_step()` on the right-hand side of a compound assignment: `x += call_step(sum, {a: 10, b: 11})`
+- Output an error if a subworkflow is empty because empty body is not allowed on GCP
+
+## Version 0.9.0 - 2025-04-23
+
+Breaking changes:
+
+- `True`, `TRUE`, `False` and `FALSE` no longer are synonyms for `true` and `false`
+
+New features:
+
+- Array and object destructuring: `const [a, b] = getArray()`
+
+Fixes:
+
+- Fix a deployment error caused by the same temp variable name being used inside and outside of a parallel branch
+
+## Version 0.8.0 - 2025-03-03
+
+- Multiple input files can be given on the command line
+- Argument `--outdir` sets the output directory
+- Argument `--project` defines the TSConfig location for the source files
+- `--(no-)generated-file-comment`: optionally include a comment about the output file being generated
+- `--version` prints the correct version number
+- Accept instantiation expressions `func<TYPE>`
+
+## Version 0.7.0 - 2025-02-02
+
+- `typeof` operator
+- `null` is allowed as interpolated value in template literal `${null}`
+- Accept `undefined` as a function argument default argument: `func(a: number | undefined = undefined)`
+- Optional function arguments: `func(a?: number)`
+
+## Version 0.6.0 - 2025-01-09
+
+Breaking changes:
+
+- retry_policy() takes a plain policy function name instead of a {policy: ...} object
+
+Fixes:
+
+- The try statement supports a finally block
+- Support empty body in a catch block
+- retry_policy() parameter values can now be expressions in addition to number literals
+- 0, "", false and null can now be used as subworkflow parameter default values
+- Type annotation fixes
+
+## Version 0.5.0 - 2024-11-09
+
+- Move nested map expressions to assign steps where necessary
+- Array.isArray() is transformed correcly in nested expressions
+
+## Version 0.4.0 - 2024-11-05
+
+- Optional chaining a?.b is converted to map.get(a, "b")
+- Non-null assertions person!.name is accepted but ignored to the transpiler
+- Merge a next step to a preceeding assign step
+- Accept a single-statement body (body without braces {}) in if, while, etc
+- Assign the result of call_step() to a member variable: obj.property = call_step()
+- parallel() and retry_policy() special functions can only be used as statements
+- Better error messages on RegExp, BigInt, spread syntax and other non-supported Javascript features
+
+## Version 0.3.0 - 2024-10-19
+
+- Function invocations no longer generate invalid empty variable names
+- Include more utility types: ReturnType, Partial, Required, etc.
+- Type annotation fixes
+
+## Version 0.2.0 - 2024-10-09
+
+- Reduce cases where maps are needlessly split off into assign statements
+- Accept (but ignore) "declare function"
+- Implemented Array.isArray()
+- Fixes to type annotations

package/dist/ast/expressions.d.ts

@@ -38,9 +38,9 @@ export declare function variableReferenceEx(variableName: VariableName): Variabl
 export interface FunctionInvocationExpression {
     readonly tag: 'functionInvocation';
     readonly functionName: string;
-    readonly arguments: Expression[];
+    readonly arguments: (Expression | undefined)[];
 }
-export declare function functionInvocationEx(functionName: string, argumentExpressions: Expression[]): FunctionInvocationExpression;
+export declare function functionInvocationEx(functionName: string, argumentExpressions: (Expression | undefined)[]): FunctionInvocationExpression;
 export interface MemberExpression {
     readonly tag: 'member';
     readonly object: Expression;

package/dist/ast/expressions.d.ts.map

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

package/dist/ast/expressions.js

@@ -89,7 +89,10 @@ export function expressionToString(ex) {
         case 'variableReference':
             return ex.variableName;
         case 'functionInvocation':
-            return `${ex.functionName}(${ex.arguments.map(expressionToString).join(', ')})`;
+            return `${ex.functionName}(${ex.arguments
+                .map((x) => x ?? nullEx)
+                .map(expressionToString)
+                .join(', ')})`;
         case 'member':
             if (ex.computed) {
                 return `${expressionToString(ex.object)}[${expressionToString(ex.property)}]`;

package/dist/transpiler/generated/functionMetadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"functionMetadata.d.ts","sourceRoot":"","sources":["../../../src/transpiler/generated/functionMetadata.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,uBAiU5B,CAAA"}
+{"version":3,"file":"functionMetadata.d.ts","sourceRoot":"","sources":["../../../src/transpiler/generated/functionMetadata.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,iBAAiB,uBA4kB5B,CAAA"}

package/dist/transpiler/generated/functionMetadata.js

@@ -320,5 +320,272 @@ export const blockingFunctions = new Map([
             "pageSize",
             "pageToken"
         ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.schemas.create",
+        [
+            "parent",
+            "schemaId",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.schemas.delete",
+        [
+            "name"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.schemas.get",
+        [
+            "name",
+            "view"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.schemas.list",
+        [
+            "parent",
+            "pageSize",
+            "pageToken",
+            "view"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.schemas.validate",
+        [
+            "parent",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.schemas.validateMessage",
+        [
+            "parent",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.snapshots.create",
+        [
+            "name",
+            "object"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.snapshots.delete",
+        [
+            "snapshot"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.snapshots.getIamPolicy",
+        [
+            "resource",
+            "options"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.snapshots.list",
+        [
+            "project",
+            "pageSize",
+            "pageToken"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.snapshots.patch",
+        [
+            "name",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.snapshots.setIamPolicy",
+        [
+            "resource",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.snapshots.testIamPermissions",
+        [
+            "resource",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.acknowledge",
+        [
+            "subscription",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.create",
+        [
+            "name",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.delete",
+        [
+            "subscription"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.detach",
+        [
+            "subscription"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.get",
+        [
+            "subscription"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.getIamPolicy",
+        [
+            "resource",
+            "options"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.list",
+        [
+            "project",
+            "pageSize",
+            "pageToken"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.modifyAckDeadline",
+        [
+            "subscription",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.modifyPushConfig",
+        [
+            "subscription",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.patch",
+        [
+            "name",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.pull",
+        [
+            "subscription",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.seek",
+        [
+            "subscription",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.setIamPolicy",
+        [
+            "resource",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.subscriptions.testIamPermissions",
+        [
+            "resource",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.topics.create",
+        [
+            "name",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.topics.delete",
+        [
+            "topic"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.topics.get",
+        [
+            "topic"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.topics.getIamPolicy",
+        [
+            "resource",
+            "options"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.topics.list",
+        [
+            "project",
+            "pageSize",
+            "pageToken"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.topics.patch",
+        [
+            "name",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.topics.publish",
+        [
+            "topic",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.topics.setIamPolicy",
+        [
+            "resource",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.topics.testIamPermissions",
+        [
+            "resource",
+            "body"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.topics.snapshots.list",
+        [
+            "topic",
+            "pageSize",
+            "pageToken"
+        ]
+    ],
+    [
+        "googleapis.pubsub.v1.projects.topics.subscriptions.list",
+        [
+            "topic",
+            "pageSize",
+            "pageToken"
+        ]
     ]
 ]);

package/dist/transpiler/linker.js

@@ -27,15 +27,19 @@ function findFunctionsRecursively(seen, typeChecker, node) {
 function findNestedFunctions(typeChecker, node) {
     const functionDeclarations = [];
     function visit(node) {
-        if (ts.isCallExpression(node)) {
-            const sig = typeChecker.getResolvedSignature(node);
-            const decl = sig?.getDeclaration();
-            if (decl && ts.isFunctionDeclaration(decl)) {
-                functionDeclarations.push(decl);
-            }
+        // isImportOrExportSpecifier() check ignores foo in "import { foo } from ..."
+        if (ts.isIdentifier(node) && !ts.isImportOrExportSpecifier(node.parent)) {
+            functionDeclarations.push(...functionDeclarationsForIdentifier(typeChecker, node));
         }
         ts.forEachChild(node, visit);
     }
     visit(node);
     return functionDeclarations;
 }
+function functionDeclarationsForIdentifier(typeChecker, node) {
+    const symbol = typeChecker.getSymbolAtLocation(node);
+    const isAliased = symbol && symbol.flags & ts.SymbolFlags.Alias;
+    const symbol2 = isAliased ? typeChecker.getAliasedSymbol(symbol) : symbol;
+    const declarations = symbol2?.getDeclarations() ?? [];
+    return declarations.filter(ts.isFunctionDeclaration);
+}

package/dist/transpiler/parseexpressions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parseexpressions.d.ts","sourceRoot":"","sources":["../../src/transpiler/parseexpressions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAkB,MAAM,sCAAsC,CAAA;AAC/E,OAAO,EAGL,UAAU,EAGV,aAAa,EACb,gBAAgB,EAChB,2BAA2B,EAc5B,MAAM,uBAAuB,CAAA;AAG9B,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,GAAG,UAAU,CAmE3E;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,CAAC,gBAAgB,GAC9B,aAAa,CA8Bf;AAmJD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,CAAC,gBAAgB,GAC9B,gBAAgB,CAOlB;AA8JD,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAGhE;AA8CD,wBAAgB,aAAa,CAC3B,CAAC,SACG,QAAQ,CAAC,UAAU,GACnB,QAAQ,CAAC,QAAQ,GACjB,QAAQ,CAAC,aAAa,GACtB,IAAI,EACR,KAAK,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAgBlD;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,iBAAiB,GACrD,QAAQ,CAAC,UAAU,CAMrB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,CAAC,UAAU,GACxB,2BAA2B,GAAG,gBAAgB,CAWhD"}
+{"version":3,"file":"parseexpressions.d.ts","sourceRoot":"","sources":["../../src/transpiler/parseexpressions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAkB,MAAM,sCAAsC,CAAA;AAC/E,OAAO,EAGL,UAAU,EAGV,aAAa,EACb,gBAAgB,EAChB,2BAA2B,EAc5B,MAAM,uBAAuB,CAAA;AAG9B,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,UAAU,GAAG,UAAU,CAmE3E;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,CAAC,gBAAgB,GAC9B,aAAa,CA8Bf;AAmJD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,CAAC,gBAAgB,GAC9B,gBAAgB,CAOlB;AA2KD,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAGhE;AA8CD,wBAAgB,aAAa,CAC3B,CAAC,SACG,QAAQ,CAAC,UAAU,GACnB,QAAQ,CAAC,QAAQ,GACjB,QAAQ,CAAC,aAAa,GACtB,IAAI,EACR,KAAK,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAgBlD;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,iBAAiB,GACrD,QAAQ,CAAC,UAAU,CAMrB;AAED,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,CAAC,UAAU,GACxB,2BAA2B,GAAG,gBAAgB,CAWhD"}

package/dist/transpiler/parseexpressions.js

@@ -286,13 +286,22 @@ function convertCallExpression(node) {
             }
             throw new WorkflowSyntaxError(msg, node.callee.loc);
         }
-        const argumentExpressions = throwIfSpread(node.arguments).map(convertExpression);
+        const argumentExpressions = throwIfSpread(node.arguments).map(convertExpressionOrUndefined);
         return functionInvocationEx(calleeName, argumentExpressions);
     }
     else {
         throw new WorkflowSyntaxError('Callee should be a qualified name', node.loc);
     }
 }
+function convertExpressionOrUndefined(instance) {
+    if (instance.type === TSESTree.AST_NODE_TYPES.Identifier &&
+        instance.name === 'undefined') {
+        return undefined;
+    }
+    else {
+        return convertExpression(instance);
+    }
+}
 export function isIntrinsic(calleeName) {
     const intrinsics = ['parallel', 'retry_policy', 'call_step'];
     return intrinsics.includes(calleeName);

package/dist/transpiler/transformations.js

@@ -8,7 +8,7 @@ import { blockingFunctions } from './generated/functionMetadata.js';
  */
 export function transformAST(statements) {
     const tempGen = createTempVariableGenerator();
-    const transform = R.pipe(R.chain(mapLiteralsAsAssigns(tempGen)), mergeAssigns, R.chain(intrinsicFunctionImplementation), R.chain(blockingCallsAsFunctionCalls(tempGen)));
+    const transform = R.pipe(R.chain(mapLiteralsAsAssigns(tempGen)), R.chain(intrinsicFunctionImplementation), R.chain(blockingCallsAsFunctionCalls(tempGen)), mergeAssigns);
     return transform(statements.map((s) => applyNested(transformAST, s)));
 }
 /**
@@ -206,7 +206,7 @@ function replaceBlockingCalls(generateName, expression) {
         }
         const blockingCallArgumentNames = blockingFunctions.get(ex.functionName);
         if (blockingCallArgumentNames) {
-            const nameAndValue = R.zip(blockingCallArgumentNames, ex.arguments);
+            const nameAndValue = R.zip(blockingCallArgumentNames, ex.arguments).filter(isDefinedArgument);
             const callArgs = R.fromPairs(nameAndValue);
             const tempCallResultVariable = generateName();
             callStatements.push(new FunctionInvocationStatement(ex.functionName, callArgs, tempCallResultVariable));
@@ -223,6 +223,9 @@ function replaceBlockingCalls(generateName, expression) {
         transformExpression(replaceBlockingFunctionInvocations, expression),
     ];
 }
+function isDefinedArgument(x) {
+    return x[1] !== undefined;
+}
 /**
  * Search for blocking calls in expressions and replace them with a call + variable.
  *
@@ -258,6 +261,7 @@ function blockingCallsAsFunctionCalls(generateTempName) {
  */
 function transformExpression(transform, ex) {
     const nestedTr = (y) => transformExpression(transform, y);
+    const nestedTr2 = R.ifElse((R.isNil), () => undefined, nestedTr);
     switch (ex.tag) {
         case 'string':
         case 'number':
@@ -272,7 +276,7 @@ function transformExpression(transform, ex) {
         case 'binary':
             return transform(binaryEx(nestedTr(ex.left), ex.binaryOperator, nestedTr(ex.right)));
         case 'functionInvocation':
-            return transform(functionInvocationEx(ex.functionName, ex.arguments.map(nestedTr)));
+            return transform(functionInvocationEx(ex.functionName, ex.arguments.map(nestedTr2)));
         case 'member':
             return transform(memberEx(nestedTr(ex.object), nestedTr(ex.property), ex.computed));
         case 'unary':
@@ -375,11 +379,19 @@ function extractMapsInMap(map, generateName, nestingLevel) {
 }
 function extractNestedMapFunctionInvocation(ex, generateName, nestingLevel) {
     const { expressions, temps } = ex.arguments.reduce((acc, arg) => {
-        const { transformedExpression, tempVariables } = extractNestedMaps(arg, generateName, nestingLevel + 1);
-        acc.expressions.push(transformedExpression);
-        acc.temps.push(...tempVariables);
+        if (arg === undefined) {
+            acc.expressions.push(undefined);
+        }
+        else {
+            const { transformedExpression, tempVariables } = extractNestedMaps(arg, generateName, nestingLevel + 1);
+            acc.expressions.push(transformedExpression);
+            acc.temps.push(...tempVariables);
+        }
         return acc;
-    }, { expressions: [], temps: [] });
+    }, {
+        expressions: [],
+        temps: [],
+    });
     return {
         transformedExpression: functionInvocationEx(ex.functionName, expressions),
         tempVariables: temps,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts2workflows",
-  "version": "0.12.0",
+  "version": "0.14.0",
   "description": "Transpile Typescript code to GCP Workflows programs",
   "homepage": "https://github.com/aajanki/ts2workflows",
   "repository": {
@@ -48,6 +48,7 @@
     "types",
     "README.md",
     "language_reference.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "author": "Antti Ajanki",
@@ -77,13 +78,16 @@
     "rimraf": "^6.0.1",
     "source-map-support": "^0.5.21",
     "tsx": "^4.20.5",
+    "typescript": "^5.5.4",
     "typescript-eslint": "^8.0.0"
   },
+  "peerDependencies": {
+    "typescript": ">=5.5.4 <6.0.0"
+  },
   "dependencies": {
     "@typescript-eslint/typescript-estree": "^8.0.0",
     "commander": "^14.0.0",
-    "ramda": "^0.31.3",
-    "typescript": "^5.5.4",
+    "ramda": "^0.32.0",
     "yaml": "^2.4.2"
   }
 }

package/types/workflowslib.d.ts

@@ -37,18 +37,28 @@ type HTTPQuery = Record<
 export declare function double(x: string | number): number
 export declare function int(x: string | number): number
 export declare function string(x: string | number | boolean): string
-export declare function keys(map: Record<string, unknown>): string[]
+export declare function keys<T extends object>(map: T): (keyof T)[]
 export declare function len(
   value: unknown[] | Record<string, unknown> | string,
 ): number
-export declare function get_type(value: unknown): string
+export declare function get_type(
+  value: unknown,
+):
+  | 'boolean'
+  | 'bytes'
+  | 'double'
+  | 'integer'
+  | 'list'
+  | 'map'
+  | 'string'
+  | 'null'
 
 // GCP Workflows standard library functions
 // https://cloud.google.com/workflows/docs/reference/stdlib/overview
 
 export declare namespace base64 {
-  function decode(data: bytes, padding?: boolean): string
-  function encode(data: string, padding?: boolean): bytes
+  function decode(data: string, padding?: boolean): bytes
+  function encode(data: bytes, padding?: boolean): string
 }
 
 export declare namespace events {
@@ -68,7 +78,7 @@ export declare namespace events {
     received_time: string
     type: string
   }
-  function create_callback_endpoint(http_callback_method: string): {
+  function create_callback_endpoint(http_callback_method?: string): {
     url: string
   }
 }
@@ -210,20 +220,33 @@ export declare namespace list {
   function prepend<T, U>(objs: T[], val: U): (T | U)[]
 }
 
+// Typescript `object` is actually too liberal as it includes arrays. Workflows
+// will throw an error if the input is an array.
 export declare namespace map {
-  function _delete<T>(map: Record<string, T>, key: string): Record<string, T>
-  // map.get() with a string key, returns a property value or null
-  export function get<T>(map: Record<string, T>, keys: string): T | null
-  // map.get() with string[] key or non-object lookup, the return type is unknown
-  export function get(map: any, keys: string | string[]): WorkflowsValue
-  export function merge<T, U>(
-    first: Record<string, T>,
-    second: Record<string, U>,
-  ): Record<string, T | U>
-  export function merge_nested<T, U>(
-    first: Record<string, T>,
-    second: Record<string, U>,
-  ): Record<string, T | U>
+  // If K is a literal key of T, return the exact type.
+  // Otherwise the best we can do is to return a Record with
+  // any of T property values.
+  function _delete<T extends object, K extends string>(
+    map: T,
+    key: K,
+  ): K extends keyof T ? Omit<T, K> : Record<string, T[keyof T]>
+  // map.get() with a string key.
+  // If K is a literal key of T, this returns the exact type T[K].
+  // Otherwise returns less exact union of all T property types or null.
+  export function get<T extends object, K extends string>(
+    map: T,
+    keys: K,
+  ): K extends keyof T ? T[K] : T[keyof T] | null
+  // map.get() with string[] key, the return type is not inferred
+  export function get(map: object, keys: string[]): WorkflowsValue
+  export function merge<T extends object, U extends object>(
+    first: T,
+    second: U,
+  ): T & U
+  export function merge_nested<T extends object, U extends object>(
+    first: T,
+    second: U,
+  ): T & U
   export { _delete as delete }
 }
 
@@ -296,9 +319,9 @@ export declare namespace uuid {
 
 // Connectors
 
-// Cloud Firestore API Connector
-// https://cloud.google.com/workflows/docs/reference/googleapis/firestore/Overview
 export declare namespace googleapis {
+  // Cloud Firestore API Connector
+  // https://cloud.google.com/workflows/docs/reference/googleapis/firestore/Overview
   namespace firestore {
     namespace v1 {
       interface ArrayValue {
@@ -515,9 +538,9 @@ export declare namespace googleapis {
         transaction?: string
       }
       interface RunQueryResponse {
-        document: Document
+        document?: Document
         readTime: string
-        skippedResults: number
+        skippedResults?: number
         transaction?: string
       }
       interface Status {
@@ -666,8 +689,8 @@ export declare namespace googleapis {
             ): PartitionQueryResponse
             export function patch(
               name: string,
-              currentDocument: Precondition,
-              mask: DocumentMask,
+              currentDocument: Precondition | undefined,
+              mask: DocumentMask | undefined,
               updateMask: DocumentMask,
               body: Pick<Document, 'fields' | 'name'>,
             ): Document
@@ -678,7 +701,7 @@ export declare namespace googleapis {
             export function runQuery(
               parent: string,
               body: RunQueryRequest,
-            ): RunQueryResponse
+            ): RunQueryResponse[]
             export { _delete as delete }
           }
           namespace operations {
@@ -706,6 +729,340 @@ export declare namespace googleapis {
       }
     }
   }
+
+  // Cloud Pub/Sub API Connector
+  // https://docs.cloud.google.com/workflows/docs/reference/googleapis/pubsub/Overview
+  namespace pubsub {
+    namespace v1 {
+      interface AcknowledgeRequest {
+        ackIds: string[]
+      }
+      interface Binding {
+        condition: Expr
+        members: string[]
+        role: string
+      }
+      interface CreateSnapshotRequest {
+        label?: Record<string, string>
+        subscription: string
+      }
+      interface DeadLetterPolicy {
+        deadLetterTopic: string
+        maxDeliveryAttempts?: number
+      }
+      interface Expr {
+        description?: string
+        expression: string
+        location?: string
+        title?: string
+      }
+      interface ExpirationPolicy {
+        ttl: string
+      }
+      interface ListSchemasResponse {
+        nextPageToken?: string
+        schemas: Schema[]
+      }
+      interface ListSnapshotsResponse {
+        nextPagetoken?: string
+        snapshots?: Snapshot[]
+      }
+      interface ListSubscriptionsResponse {
+        nextPageToken?: string
+        subscriptions?: Subscription[]
+      }
+      interface ListTopicsResponse {
+        nextPageToken?: string
+        topics?: Topic[]
+      }
+      interface ListTopicSubscriptionsResponse {
+        nextPageToken?: string
+        subscriptions?: string[]
+      }
+      interface ListTopicSnapshotsResponse {
+        nextPageToken?: string
+        snapshots?: string[]
+      }
+      interface MessageStoragePolicy {
+        allowedPersistenceRegions?: string[]
+      }
+      interface ModifyAckDeadlineRequest {
+        ackDeadlineSeconds: number
+        ackIds: string[]
+      }
+      interface ModifyPushConfigRequest {
+        pushConfig: PushConfig
+      }
+      interface OidcToken {
+        audience: string
+        serviceAccountEmail: string
+      }
+      interface Policy {
+        bindings: Binding[]
+        etag: string
+        version: number
+      }
+      interface PublishRequest {
+        messages: PubsubMessage[]
+      }
+      interface PublishResponse {
+        messageIds?: string[]
+      }
+      interface PubsubMessage {
+        attributes?: Record<string, string>
+        data?: string
+        messageId?: string
+        orderingKey?: string
+        publishTime?: string
+      }
+      interface PullRequest {
+        maxMessages: number
+        returnImmediately?: boolean
+      }
+      interface PullResponse {
+        receivedMessages: ReceivedMessage[]
+      }
+      interface PushConfig {
+        attributes: Record<string, string>
+        oidcToken: OidcToken
+        pushEndpoint: string
+      }
+      interface ReceivedMessage {
+        ackId: string
+        deliveryAttempt: number
+        message: PubsubMessage
+      }
+      interface RetryPolicy {
+        maximumBackoff?: string
+        minimumBackoff?: string
+      }
+      interface Schema {
+        definition: string
+        name: string
+        type: 'TYPE_UNSPECIFIED' | 'PROTOCOL_BUFFER' | 'AVRO'
+      }
+      interface SchemaSettings {
+        encoding?: 'ENCODING_UNSPECIFIED' | 'JSON' | 'BINARY'
+        schema: string
+      }
+      interface SeekRequest {
+        snapshot?: string
+        time?: string
+      }
+      interface SetIamPolicyRequest {
+        policy: Policy
+      }
+      interface Snapshot {
+        expireTime?: string
+        labels?: Record<string, string>
+        name?: string
+        topic?: string
+      }
+      interface Subscription {
+        ackDeadlineSeconds?: number
+        deadLetterPolicy?: DeadLetterPolicy
+        detached?: boolean
+        enableMessageOrdering?: boolean
+        expirationPolicy?: ExpirationPolicy
+        filter?: string
+        labels?: Record<string, string>
+        messageRetentionDuration?: string
+        name: string
+        pushConfig?: PushConfig
+        retainAckedMessages?: boolean
+        retryPolicy?: RetryPolicy
+        topic: string
+        topicMessageRetentionDuration?: string
+      }
+      interface TestIamPermissionsRequest {
+        permissions: string[]
+      }
+      interface TestIamPermissionsResponse {
+        permissions: string[]
+      }
+      interface Topic {
+        kmsKeyName?: string
+        labels?: Map<string, string>
+        messageRetentionDuration?: string
+        messageStoragePolicy?: MessageStoragePolicy
+        name: string
+        satisfiesPzs?: boolean
+        schemaSettings?: SchemaSettings
+      }
+      interface UpdateSnapshotRequest {
+        snapshot: Snapshot
+        updateMask: string
+      }
+      interface UpdateSubscriptionRequest {
+        subscription: Subscription
+        updateMask: string
+      }
+      interface UpdateTopicRequest {
+        topic: Topic
+        updateMask: string
+      }
+      interface ValidateMessageRequest {
+        encoding: 'ENCODING_UNSPECIFIED' | 'JSON' | 'BINARY'
+        message: string
+        name?: string
+        schema?: Schema
+      }
+      interface ValidateSchemaRequest {
+        object: Schema
+      }
+
+      namespace projects {
+        namespace schemas {
+          export function create(
+            parent: string,
+            schemaId: string,
+            body: Schema,
+          ): Schema
+          function _delete(name: string): void
+          export { _delete as delete }
+          export function get(
+            name: string,
+            view?: 'SCHEMA_VIEW_UNSPECIFIED' | 'BASIC' | 'FULL',
+          ): Schema
+          export function list(
+            parent: string,
+            pageSize?: number,
+            pageToken?: string,
+            view?: 'SCHEMA_VIEW_UNSPECIFIED' | 'BASIC' | 'FULL',
+          ): ListSchemasResponse
+          export function validate(
+            parent: string,
+            body: ValidateSchemaRequest,
+          ): void
+          export function validateMessage(
+            parent: string,
+            body: ValidateMessageRequest,
+          ): void
+        }
+
+        namespace snapshots {
+          export function create(
+            name: string,
+            object: CreateSnapshotRequest,
+          ): Snapshot
+          function _delete(snapshot: string): void
+          export { _delete as delete }
+          export function getIamPolicy(
+            resource: string,
+            options: { requestedPolicyVersion: number },
+          ): Policy
+          export function list(
+            project: string,
+            pageSize?: number,
+            pageToken?: string,
+          ): ListSnapshotsResponse
+          export function patch(
+            name: string,
+            body: UpdateSnapshotRequest,
+          ): Snapshot
+          export function setIamPolicy(
+            resource: string,
+            body: SetIamPolicyRequest,
+          ): Policy
+          export function testIamPermissions(
+            resource: string,
+            body: TestIamPermissionsRequest,
+          ): TestIamPermissionsResponse
+        }
+
+        namespace subscriptions {
+          export function acknowledge(
+            subscription: string,
+            body: AcknowledgeRequest,
+          ): void
+          export function create(name: string, body: Subscription): Subscription
+          function _delete(subscription: string): void
+          export { _delete as delete }
+          export function detach(subscription: string): void
+          export function get(subscription: string): Subscription
+          export function getIamPolicy(
+            resource: string,
+            options: { requestedPolicyVersion: number },
+          ): Policy
+          export function list(
+            project: string,
+            pageSize?: number,
+            pageToken?: string,
+          ): ListSubscriptionsResponse
+          export function modifyAckDeadline(
+            subscription: string,
+            body: ModifyAckDeadlineRequest,
+          ): void
+          export function modifyPushConfig(
+            subscription: string,
+            body: ModifyPushConfigRequest,
+          ): void
+          export function patch(
+            name: string,
+            body: UpdateSubscriptionRequest,
+          ): Subscription
+          export function pull(
+            subscription: string,
+            body: PullRequest,
+          ): PullResponse
+          export function seek(subscription: string, body: SeekRequest): void
+          export function setIamPolicy(
+            resource: string,
+            body: SetIamPolicyRequest,
+          ): Policy
+          export function testIamPermissions(
+            resource: string,
+            body: TestIamPermissionsRequest,
+          ): TestIamPermissionsResponse
+        }
+
+        namespace topics {
+          export function create(name: string, body: Topic): Topic
+          function _delete(topic: string): void
+          export { _delete as delete }
+          export function get(topic: string): Topic
+          export function getIamPolicy(
+            resource: string,
+            options: { requestedPolicyVersion: number },
+          ): Policy
+          export function list(
+            project: string,
+            pageSize?: number,
+            pageToken?: string,
+          ): ListTopicsResponse
+          export function patch(name: string, body: UpdateTopicRequest): Topic
+          export function publish(
+            topic: string,
+            body: PublishRequest,
+          ): PublishResponse
+          export function setIamPolicy(
+            resource: string,
+            body: SetIamPolicyRequest,
+          ): Policy
+          export function testIamPermissions(
+            resource: string,
+            body: TestIamPermissionsRequest,
+          ): TestIamPermissionsResponse
+
+          namespace snapshots {
+            export function list(
+              topic: string,
+              pageSize?: number,
+              pageToken?: string,
+            ): ListTopicSnapshotsResponse
+          }
+
+          namespace subscriptions {
+            export function list(
+              topic: string,
+              pageSize?: number,
+              pageToken?: string,
+            ): ListTopicSubscriptionsResponse
+          }
+        }
+      }
+    }
+  }
 }
 
 // Functionality that is not implemented by Typescript keywords