@knocklabs/cli 0.1.14 → 0.1.15

package/README.md

@@ -16,7 +16,7 @@ $ npm install -g @knocklabs/cli
 $ knock COMMAND
 running command...
 $ knock (--version)
-@knocklabs/cli/0.1.14 linux-x64 node-v18.20.2
+@knocklabs/cli/0.1.15 linux-x64 node-v18.20.2
 $ knock --help [COMMAND]
 USAGE
   $ knock COMMAND
@@ -31,7 +31,7 @@ USAGE
 * [`knock commit get ID`](#knock-commit-get-id)
 * [`knock commit list`](#knock-commit-list)
 * [`knock commit promote`](#knock-commit-promote)
-* [`knock help [COMMANDS]`](#knock-help-commands)
+* [`knock help [COMMAND]`](#knock-help-command)
 * [`knock layout get EMAILLAYOUTKEY`](#knock-layout-get-emaillayoutkey)
 * [`knock layout list`](#knock-layout-list)
 * [`knock layout pull [EMAILLAYOUTKEY]`](#knock-layout-pull-emaillayoutkey)
@@ -78,7 +78,7 @@ FLAGS
       --service-token=<value>   (required) The service token to authenticate with.
 ```
 
-_See code: [src/commands/commit/index.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/commit/index.ts)_
+_See code: [src/commands/commit/index.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/commit/index.ts)_
 
 ## `knock commit get ID`
 
@@ -95,7 +95,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/commit/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/commit/get.ts)_
+_See code: [src/commands/commit/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/commit/get.ts)_
 
 ## `knock commit list`
 
@@ -119,7 +119,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/commit/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/commit/list.ts)_
+_See code: [src/commands/commit/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/commit/list.ts)_
 
 ## `knock commit promote`
 
@@ -136,18 +136,18 @@ FLAGS
   --to=<value>             The destination environment to promote all changes from the preceding environment.
 ```
 
-_See code: [src/commands/commit/promote.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/commit/promote.ts)_
+_See code: [src/commands/commit/promote.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/commit/promote.ts)_
 
-## `knock help [COMMANDS]`
+## `knock help [COMMAND]`
 
 Display help for knock.
 
 ```
 USAGE
-  $ knock help [COMMANDS...] [-n]
+  $ knock help [COMMAND...] [-n]
 
 ARGUMENTS
-  COMMANDS...  Command to show help for.
+  COMMAND...  Command to show help for.
 
 FLAGS
   -n, --nested-commands  Include all nested commands in the output.
@@ -156,7 +156,7 @@ DESCRIPTION
   Display help for knock.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.0.14/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.0.21/src/commands/help.ts)_
 
 ## `knock layout get EMAILLAYOUTKEY`
 
@@ -176,7 +176,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/layout/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/layout/get.ts)_
+_See code: [src/commands/layout/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/layout/get.ts)_
 
 ## `knock layout list`
 
@@ -199,7 +199,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/layout/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/layout/list.ts)_
+_See code: [src/commands/layout/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/layout/list.ts)_
 
 ## `knock layout pull [EMAILLAYOUTKEY]`
 
@@ -219,7 +219,7 @@ FLAGS
   --service-token=<value>     (required) The service token to authenticate with.
 ```
 
-_See code: [src/commands/layout/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/layout/pull.ts)_
+_See code: [src/commands/layout/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/layout/pull.ts)_
 
 ## `knock layout push [EMAILLAYOUTKEY]`
 
@@ -241,7 +241,7 @@ FLAGS
       --service-token=<value>   (required) The service token to authenticate with.
 ```
 
-_See code: [src/commands/layout/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/layout/push.ts)_
+_See code: [src/commands/layout/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/layout/push.ts)_
 
 ## `knock layout validate [EMAILLAYOUTKEY]`
 
@@ -260,7 +260,7 @@ FLAGS
   --service-token=<value>  (required) The service token to authenticate with.
 ```
 
-_See code: [src/commands/layout/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/layout/validate.ts)_
+_See code: [src/commands/layout/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/layout/validate.ts)_
 
 ## `knock plugins`
 
@@ -548,7 +548,7 @@ Display a single translation from an environment.
 ```
 USAGE
   $ knock translation get TRANSLATIONREF --service-token <value> [--json] [--environment <value>]
-    [--hide-uncommitted-changes]
+    [--hide-uncommitted-changes] [--format json|po]
 
 ARGUMENTS
   TRANSLATIONREF  Translation ref is a identifier string that refers to a unique translation.
@@ -557,6 +557,8 @@ ARGUMENTS
 
 FLAGS
   --environment=<value>       [default: development] The environment to use.
+  --format=<option>           [default: json] Specify the output format of the returned translations.
+                              <options: json|po>
   --hide-uncommitted-changes  Hide any uncommitted changes.
   --service-token=<value>     (required) The service token to authenticate with.
 
@@ -564,7 +566,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/translation/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/translation/get.ts)_
+_See code: [src/commands/translation/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/translation/get.ts)_
 
 ## `knock translation list`
 
@@ -587,7 +589,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/translation/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/translation/list.ts)_
+_See code: [src/commands/translation/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/translation/list.ts)_
 
 ## `knock translation pull [TRANSLATIONREF]`
 
@@ -596,7 +598,7 @@ Pull one or more translations from an environment into a local file system.
 ```
 USAGE
   $ knock translation pull [TRANSLATIONREF] --service-token <value> [--environment <value>] [--translations-dir
-    <value> --all] [--hide-uncommitted-changes] [--force]
+    <value> --all] [--hide-uncommitted-changes] [--force] [--format json|po]
 
 ARGUMENTS
   TRANSLATIONREF  Translation ref is a identifier string that refers to a unique translation.
@@ -607,12 +609,14 @@ FLAGS
   --all                       Whether to pull all translations from the specified environment.
   --environment=<value>       [default: development] The environment to use.
   --force                     Remove the confirmation prompt.
+  --format=<option>           [default: json] Specify the output format of the returned translations.
+                              <options: json|po>
   --hide-uncommitted-changes  Hide any uncommitted changes.
   --service-token=<value>     (required) The service token to authenticate with.
   --translations-dir=<value>  The target directory path to pull all translations into.
 ```
 
-_See code: [src/commands/translation/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/translation/pull.ts)_
+_See code: [src/commands/translation/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/translation/pull.ts)_
 
 ## `knock translation push [TRANSLATIONREF]`
 
@@ -639,7 +643,7 @@ FLAGS
       --translations-dir=<value>  The target directory path to find all translations to push.
 ```
 
-_See code: [src/commands/translation/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/translation/push.ts)_
+_See code: [src/commands/translation/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/translation/push.ts)_
 
 ## `knock translation validate [TRANSLATIONREF]`
 
@@ -664,7 +668,7 @@ FLAGS
   --translations-dir=<value>  The target directory path to find all translations to validate.
 ```
 
-_See code: [src/commands/translation/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/translation/validate.ts)_
+_See code: [src/commands/translation/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/translation/validate.ts)_
 
 ## `knock whoami`
 
@@ -681,7 +685,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/whoami.ts)_
 
 ## `knock workflow activate WORKFLOWKEY`
 
@@ -708,7 +712,7 @@ DESCRIPTION
   with `false` in order to deactivate it.
 ```
 
-_See code: [src/commands/workflow/activate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/workflow/activate.ts)_
+_See code: [src/commands/workflow/activate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/workflow/activate.ts)_
 
 ## `knock workflow get WORKFLOWKEY`
 
@@ -728,7 +732,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/workflow/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/workflow/get.ts)_
+_See code: [src/commands/workflow/get.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/workflow/get.ts)_
 
 ## `knock workflow list`
 
@@ -751,7 +755,7 @@ GLOBAL FLAGS
   --json  Format output as json.
 ```
 
-_See code: [src/commands/workflow/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/workflow/list.ts)_
+_See code: [src/commands/workflow/list.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/workflow/list.ts)_
 
 ## `knock workflow pull [WORKFLOWKEY]`
 
@@ -771,7 +775,7 @@ FLAGS
   --workflows-dir=<value>     The target directory path to pull all workflows into.
 ```
 
-_See code: [src/commands/workflow/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/workflow/pull.ts)_
+_See code: [src/commands/workflow/pull.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/workflow/pull.ts)_
 
 ## `knock workflow push [WORKFLOWKEY]`
 
@@ -792,7 +796,7 @@ FLAGS
       --workflows-dir=<value>   The target directory path to find all workflows to push.
 ```
 
-_See code: [src/commands/workflow/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/workflow/push.ts)_
+_See code: [src/commands/workflow/push.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/workflow/push.ts)_
 
 ## `knock workflow run WORKFLOWKEY`
 
@@ -813,7 +817,7 @@ FLAGS
   --tenant=<value>         A tenant id for the workflow run.
 ```
 
-_See code: [src/commands/workflow/run.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/workflow/run.ts)_
+_See code: [src/commands/workflow/run.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/workflow/run.ts)_
 
 ## `knock workflow validate [WORKFLOWKEY]`
 
@@ -832,5 +836,5 @@ FLAGS
   --workflows-dir=<value>  The target directory path to find all workflows to validate.
 ```
 
-_See code: [src/commands/workflow/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.14/src/commands/workflow/validate.ts)_
+_See code: [src/commands/workflow/validate.ts](https://github.com/knocklabs/knock-cli/blob/v0.1.15/src/commands/workflow/validate.ts)_
 <!-- commandsstop -->

package/dist/commands/translation/get.js

@@ -85,7 +85,7 @@ class TranslationGet extends _basecommand.default {
     }
     render(translation) {
         const { translationRef } = this.props.args;
-        const { environment: env, "hide-uncommitted-changes": commitedOnly } = this.props.flags;
+        const { environment: env, "hide-uncommitted-changes": commitedOnly, format } = this.props.flags;
         const qualifier = env === "development" && !commitedOnly ? "(including uncommitted)" : "";
         this.log(`‣ Showing translation \`${translationRef}\` in \`${env}\` environment ${qualifier}\n`);
         /*
@@ -123,7 +123,11 @@ class TranslationGet extends _basecommand.default {
             }
         });
         this.log("");
-        _core.ux.styledJSON(JSON.parse(translation.content));
+        if (format === "json") {
+            _core.ux.styledJSON(JSON.parse(translation.content));
+        } else {
+            _core.ux.log(translation.content);
+        }
     }
 }
 _define_property(TranslationGet, "summary", "Display a single translation from an environment.");
@@ -134,7 +138,15 @@ _define_property(TranslationGet, "flags", {
     }),
     "hide-uncommitted-changes": _core.Flags.boolean({
         summary: "Hide any uncommitted changes."
-    })
+    }),
+    format: _core.Flags.option({
+        summary: "Specify the output format of the returned translations.",
+        options: [
+            "json",
+            "po"
+        ],
+        default: "json"
+    })()
 });
 _define_property(TranslationGet, "args", {
     translationRef: _core.Args.string({

package/dist/commands/translation/pull.js

@@ -102,7 +102,9 @@ class TranslationPull extends _basecommand.default {
             if (!input) return;
         }
         const resp = await (0, _request.withSpinner)(()=>this.apiV1.getTranslation(this.props, targetCtx));
-        await _translation.writeTranslationFile(targetCtx, resp.data);
+        await _translation.writeTranslationFile(targetCtx, resp.data, {
+            format: flags.format
+        });
         const actioned = targetCtx.exists ? "updated" : "created";
         this.log(`‣ Successfully ${actioned} \`${targetCtx.ref}\` at ${targetCtx.abspath}`);
     }
@@ -120,7 +122,9 @@ class TranslationPull extends _basecommand.default {
             localeCode: targetCtx.key
         };
         const translations = await this.listAllTranslations(filters);
-        await _translation.writeTranslationFiles(targetCtx, translations);
+        await _translation.writeTranslationFiles(targetCtx, translations, {
+            format: flags.format
+        });
         _ux.spinner.stop();
         const actioned = targetCtx.exists ? "updated" : "created";
         this.log(`‣ Successfully ${actioned} the \`${targetCtx.key}\` translations directory at ${targetCtx.abspath}`);
@@ -135,7 +139,9 @@ class TranslationPull extends _basecommand.default {
         // Fetch all translations then write them to the local file system.
         _ux.spinner.start(`‣ Loading`);
         const translations = await this.listAllTranslations();
-        await _translation.writeTranslationFiles(targetCtx, translations);
+        await _translation.writeTranslationFiles(targetCtx, translations, {
+            format: flags.format
+        });
         _ux.spinner.stop();
         const action = targetCtx.exists ? "updated" : "created";
         this.log(`‣ Successfully ${action} the translations directory at ${targetCtx.abspath}`);
@@ -182,7 +188,15 @@ _define_property(TranslationPull, "flags", {
     }),
     force: _core.Flags.boolean({
         summary: "Remove the confirmation prompt."
-    })
+    }),
+    format: _core.Flags.option({
+        summary: "Specify the output format of the returned translations.",
+        options: [
+            "json",
+            "po"
+        ],
+        default: "json"
+    })()
 });
 _define_property(TranslationPull, "args", {
     translationRef: _core.Args.string({

package/dist/commands/translation/push.js

@@ -107,7 +107,8 @@ class TranslationPush extends _basecommand.default {
             const resp = await this.apiV1.upsertTranslation(this.props, {
                 locale_code: translation.localeCode,
                 namespace: translation.namespace,
-                content: translation.content
+                content: translation.content,
+                format: translation.format
             });
             if ((0, _request.isSuccessResp)(resp)) continue;
             const message = (0, _request.formatErrorRespMessage)(resp);

package/dist/commands/translation/validate.js

@@ -106,7 +106,8 @@ class TranslationValidate extends _basecommand.default {
             const resp = await api.validateTranslation(props, {
                 locale_code: translation.localeCode,
                 namespace: translation.namespace,
-                content: translation.content
+                content: translation.content,
+                format: translation.format
             });
             if ((0, _request.isSuccessResp)(resp)) return;
             const message = (0, _request.formatErrorRespMessage)(resp);

package/dist/lib/api-v1.js

@@ -149,6 +149,7 @@ class ApiV1 {
             hide_uncommitted_changes: flags["hide-uncommitted-changes"],
             locale_code: filters.localeCode,
             namespace: filters.namespace,
+            format: flags.format,
             ...(0, _page.toPageParams)(flags)
         });
         return this.get("/translations", {
@@ -159,7 +160,8 @@ class ApiV1 {
         const params = (0, _objectisomorphic.prune)({
             environment: flags.environment,
             hide_uncommitted_changes: flags["hide-uncommitted-changes"],
-            namespace: translation.namespace
+            namespace: translation.namespace,
+            format: flags.format
         });
         return this.get(`/translations/${translation.localeCode}`, {
             params

package/dist/lib/marshal/translation/helpers.js

@@ -104,15 +104,15 @@ const isTranslationDir = (dirPath)=>{
     const locale = _nodepath.basename(dirPath);
     return isValidLocale(locale);
 };
-const buildTranslationFileCtx = async (dirPath, localeCode, namespace)=>{
-    const ref = (0, _processorisomorphic.formatRef)(localeCode, namespace);
-    const filename = (0, _processorisomorphic.formatFileName)(ref);
+const buildTranslationFileCtx = async (dirPath, translationIdentifier, options)=>{
+    const ref = (0, _processorisomorphic.formatRef)(translationIdentifier.localeCode, translationIdentifier.namespace);
+    const filename = (0, _processorisomorphic.formatFileName)(ref, options);
     const abspath = _nodepath.resolve(dirPath, filename);
     const exists = await _fsextra.pathExists(abspath);
     return {
         ref,
-        localeCode,
-        namespace,
+        localeCode: translationIdentifier.localeCode,
+        namespace: translationIdentifier.namespace,
         abspath,
         exists
     };
@@ -182,10 +182,34 @@ const ensureValidCommandTarget = async (props, runContext)=>{
     // Got translationRef arg but no --all flag, which means target only a single
     // translation file.
     if (!flags.all) {
-        const translationFileCtx = await buildTranslationFileCtx(targetDirPath, localeCode, namespace);
+        // If specified, check the given format; otherwise check for all supported formats
+        const formats = flags.format ? [
+            flags.format
+        ] : _processorisomorphic.SUPPORTED_TRANSLATION_FORMATS;
+        const translationFileCtxs = await Promise.all(formats.map(async (format)=>buildTranslationFileCtx(targetDirPath, {
+                localeCode,
+                namespace
+            }, {
+                format
+            })));
+        if (flags.format) {
+            return {
+                type: "translationFile",
+                context: translationFileCtxs[0]
+            };
+        }
+        // If no format is specified, look for the first existing file and return that context
+        const existingFileCtx = translationFileCtxs.find((ctx)=>ctx.exists);
+        if (existingFileCtx) {
+            return {
+                type: "translationFile",
+                context: existingFileCtx
+            };
+        }
+        // If no file exists, fall back to the file context with the default format (json)
         return {
             type: "translationFile",
-            context: translationFileCtx
+            context: translationFileCtxs[0]
         };
     }
     // From this point on, we have both translationRef and --all flag used
@@ -212,7 +236,8 @@ const lsTranslationDir = async (pathToDir)=>{
     return dirents.filter((dirent)=>{
         if (dirent.isDirectory()) return false;
         const filename = dirent.name.toLowerCase();
-        if (!filename.endsWith(`${localeCode}.json`)) return false;
+        const isValidExtension = _processorisomorphic.SUPPORTED_TRANSLATION_FORMATS.some((extension)=>filename.endsWith(`${localeCode}.${extension}`));
+        if (!isValidExtension) return false;
         const { name: translationRef } = _nodepath.parse(filename);
         const parsedRef = parseTranslationRef(translationRef);
         if (!parsedRef) return false;

package/dist/lib/marshal/translation/processor.isomorphic.js

@@ -9,6 +9,12 @@ function _export(target, all) {
     });
 }
 _export(exports, {
+    DEFAULT_TRANSLATION_FORMAT: function() {
+        return DEFAULT_TRANSLATION_FORMAT;
+    },
+    SUPPORTED_TRANSLATION_FORMATS: function() {
+        return SUPPORTED_TRANSLATION_FORMATS;
+    },
     buildTranslationDirBundle: function() {
         return buildTranslationDirBundle;
     },
@@ -19,21 +25,35 @@ _export(exports, {
         return formatRef;
     }
 });
+const SUPPORTED_TRANSLATION_FORMATS = [
+    "json",
+    "po"
+];
+const DEFAULT_TRANSLATION_FORMAT = "json";
 const formatRef = (localeCode, namespace)=>namespace ? `${namespace}.${localeCode}` : localeCode;
-const formatFileName = (input)=>{
+const formatFileName = (input, options)=>{
+    var _options_format;
+    const extension = (_options_format = options === null || options === void 0 ? void 0 : options.format) !== null && _options_format !== void 0 ? _options_format : DEFAULT_TRANSLATION_FORMAT;
     const ref = typeof input === "string" ? input : formatRef(input.locale_code, input.namespace);
-    return `${ref}.json`;
+    return `${ref}.${extension}`;
 };
-const buildTranslationDirBundle = (input)=>{
+const buildTranslationDirBundle = (input, options)=>{
+    var _options_format;
+    const format = (_options_format = options === null || options === void 0 ? void 0 : options.format) !== null && _options_format !== void 0 ? _options_format : DEFAULT_TRANSLATION_FORMAT;
     if (Array.isArray(input)) {
         const translations = input;
         return Object.fromEntries(translations.map((translation)=>[
-                formatFileName(translation),
+                formatFileName(translation, {
+                    format
+                }),
                 JSON.parse(translation.content)
             ]));
     }
     const translation = input;
+    const content = format === "json" ? JSON.parse(translation.content) : translation.content;
     return {
-        [formatFileName(translation)]: JSON.parse(translation.content)
+        [formatFileName(translation, {
+            format
+        })]: content
     };
 };

package/dist/lib/marshal/translation/reader.js

@@ -14,6 +14,7 @@ const _fsextra = /*#__PURE__*/ _interop_require_wildcard(require("fs-extra"));
 const _error = require("../../helpers/error");
 const _json = require("../../helpers/json");
 const _helpers = require("./helpers");
+const _processorisomorphic = require("./processor.isomorphic");
 function _getRequireWildcardCache(nodeInterop) {
     if (typeof WeakMap !== "function") return null;
     var cacheBabelInterop = new WeakMap();
@@ -76,10 +77,9 @@ function _interop_require_wildcard(obj, nodeInterop) {
         // push commands. Consider making this an option in the future.
         if (namespace === _helpers.SYSTEM_NAMESPACE) continue;
         // eslint-disable-next-line no-await-in-loop
-        const [content, readJsonErrors] = await (0, _json.readJson)(abspath);
-        if (readJsonErrors.length > 0) {
-            const e = new _error.SourceError((0, _error.formatErrors)(readJsonErrors), abspath);
-            errors.push(e);
+        const [content, sourceError, format] = await readTranslationFile(abspath);
+        if (sourceError) {
+            errors.push(sourceError);
             continue;
         }
         translations.push({
@@ -88,7 +88,8 @@ function _interop_require_wildcard(obj, nodeInterop) {
             namespace,
             abspath,
             exists: true,
-            content: JSON.stringify(content)
+            content,
+            format
         });
     }
     return [
@@ -96,6 +97,56 @@ function _interop_require_wildcard(obj, nodeInterop) {
         errors
     ];
 };
+const readTranslationFile = async (filePath)=>{
+    // Get translation format from file extension
+    const format = getFormatFromFilePath(filePath);
+    switch(format){
+        case "json":
+            {
+                const [jsonContent, readErrors] = await (0, _json.readJson)(filePath);
+                if (readErrors.length > 0) {
+                    const e = new _error.SourceError((0, _error.formatErrors)(readErrors), filePath);
+                    return [
+                        undefined,
+                        e,
+                        format
+                    ];
+                }
+                const content = JSON.stringify(jsonContent);
+                return [
+                    content,
+                    undefined,
+                    format
+                ];
+            }
+        case "po":
+            {
+                try {
+                    const content = await _fsextra.readFile(filePath, "utf8");
+                    return [
+                        content,
+                        undefined,
+                        format
+                    ];
+                } catch (error) {
+                    const e = new _error.SourceError(error.message, filePath);
+                    return [
+                        undefined,
+                        e,
+                        format
+                    ];
+                }
+            }
+        default:
+            throw new Error(`unsupported translation file extension: ${filePath}`);
+    }
+};
+const getFormatFromFilePath = (filePath)=>{
+    // Path.extname returns the extension with a period (e.g. .json)
+    // so we use slice to get just the name
+    const extension = _nodepath.extname(filePath).slice(1);
+    return _processorisomorphic.SUPPORTED_TRANSLATION_FORMATS.includes(extension) ? extension : undefined;
+};
 const readAllForCommandTarget = async (target)=>{
     const { type: targetType, context: targetCtx } = target;
     if (!targetCtx.exists) {

package/dist/lib/marshal/translation/types.js

@@ -1,4 +1,3 @@
-// Translation payload data from the API.
 "use strict";
 Object.defineProperty(exports, "__esModule", {
     value: true

package/dist/lib/marshal/translation/writer.js

@@ -22,6 +22,7 @@ const _lodash = require("lodash");
 const _const = require("../../helpers/const");
 const _json = require("../../helpers/json");
 const _helpers = require("./helpers");
+const _processorisomorphic = require("./processor.isomorphic");
 function _getRequireWildcardCache(nodeInterop) {
     if (typeof WeakMap !== "function") return null;
     var cacheBabelInterop = new WeakMap();
@@ -63,10 +64,21 @@ function _interop_require_wildcard(obj, nodeInterop) {
     }
     return newObj;
 }
-const writeTranslationFile = async (translationFileCtx, translation)=>_fsextra.outputJson(translationFileCtx.abspath, JSON.parse(translation.content), {
-        spaces: _json.DOUBLE_SPACES
-    });
-const writeTranslationFiles = async (targetDirCtx, translations)=>{
+const writeTranslationFile = async (translationFileCtx, translation, options)=>{
+    var _options_format;
+    const format = (_options_format = options === null || options === void 0 ? void 0 : options.format) !== null && _options_format !== void 0 ? _options_format : _processorisomorphic.DEFAULT_TRANSLATION_FORMAT;
+    switch(format){
+        case "json":
+            return _fsextra.outputJson(translationFileCtx.abspath, JSON.parse(translation.content), {
+                spaces: _json.DOUBLE_SPACES
+            });
+        case "po":
+            return _fsextra.outputFile(translationFileCtx.abspath, translation.content);
+        default:
+            throw new Error(`Invalid translation file format: ${options === null || options === void 0 ? void 0 : options.format}`);
+    }
+};
+const writeTranslationFiles = async (targetDirCtx, translations, options)=>{
     const backupDirPath = _nodepath.resolve(_const.sandboxDir, (0, _lodash.uniqueId)("backup"));
     try {
         // If the index directory already exists, back it up in the temp sandbox
@@ -81,8 +93,11 @@ const writeTranslationFiles = async (targetDirCtx, translations)=>{
             // to write translation files in; otherwise for translations index
             // directory, we want to nest translation files under each locale dir.
             const localeDirPath = "key" in targetDirCtx ? targetDirCtx.abspath : _nodepath.resolve(targetDirCtx.abspath, translation.locale_code);
-            const translationFileCtx = await (0, _helpers.buildTranslationFileCtx)(localeDirPath, translation.locale_code, translation.namespace);
-            return writeTranslationFile(translationFileCtx, translation);
+            const translationFileCtx = await (0, _helpers.buildTranslationFileCtx)(localeDirPath, {
+                localeCode: translation.locale_code,
+                namespace: translation.namespace
+            }, options);
+            return writeTranslationFile(translationFileCtx, translation, options);
         });
         await Promise.all(writeTranslationDirPromises);
     } catch (error) {

package/oclif.manifest.json

@@ -817,6 +817,18 @@
           "summary": "Hide any uncommitted changes.",
           "allowNo": false,
           "type": "boolean"
+        },
+        "format": {
+          "name": "format",
+          "summary": "Specify the output format of the returned translations.",
+          "default": "json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "po"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -979,6 +991,18 @@
           "summary": "Remove the confirmation prompt.",
           "allowNo": false,
           "type": "boolean"
+        },
+        "format": {
+          "name": "format",
+          "summary": "Specify the output format of the returned translations.",
+          "default": "json",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "json",
+            "po"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
@@ -1758,5 +1782,5 @@
       ]
     }
   },
-  "version": "0.1.14"
+  "version": "0.1.15"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knocklabs/cli",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "Knock CLI",
   "author": "@knocklabs",
   "bin": {
@@ -21,18 +21,18 @@
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-plugins": "^4",
     "@prantlf/jsonlint": "^14.0.3",
-    "axios": "^1.5.1",
+    "axios": "^1.6.8",
     "date-fns": "^2.30.0",
     "enquirer": "^2.4.1",
     "fs-extra": "^11.2.0",
-    "liquidjs": "^10.10.2",
+    "liquidjs": "^10.12.0",
     "locale-codes": "^1.3.1",
     "lodash": "^4.17.21",
     "yup": "^1.4.0"
   },
   "devDependencies": {
     "@oclif/test": "^3",
-    "@swc/cli": "^0.3.9",
+    "@swc/cli": "^0.3.12",
     "@swc/core": "^1.4.6",
     "@swc/helpers": "^0.5.6",
     "@types/chai": "^4",
@@ -47,7 +47,7 @@
     "eslint-plugin-prettier": "^4.2.1",
     "eslint-plugin-simple-import-sort": "^10.0.0",
     "mocha": "^10",
-    "nock": "^13.5.3",
+    "nock": "^13.5.4",
     "oclif": "^4",
     "prettier": "2.8.8",
     "shx": "^0.3.4",