Sync alphalib

Author: kvz

src/alphalib/types/robots/_instructions-primitives.ts

@@ -1,5 +1,6 @@
 import { z } from 'zod'
 
+import { stackVersions } from '../stackVersions.ts'
 import type { assemblyInstructionsSchema } from '../template'
 
 export const interpolationSchemaToYieldNumber = z.string().regex(/^[\d.]*\${.+}[\d.]*$/)
@@ -465,7 +466,7 @@ If the value is not specified and the \`preset\` parameter is available, the \`p
       .optional().describe(`
 Converts a video according to [pre-configured settings](/docs/transcoding/video-encoding/video-presets/).
 
-If you specify your own FFmpeg parameters using the <dfn>Robot</dfn>'s and/or do not not want Transloadit to set any encoding setting, starting \`ffmpeg_stack: "{{stacks.ffmpeg.recommended_version}}"\`,  you can use the value \`'empty'\` here.
+If you specify your own FFmpeg parameters using the <dfn>Robot</dfn>'s and/or do not not want Transloadit to set any encoding setting, starting \`ffmpeg_stack: "${stackVersions.ffmpeg.recommendedVersion}"\`,  you can use the value \`'empty'\` here.
 `),
   })
   .strict()

src/alphalib/types/robots/audio-artwork.ts

@@ -2,6 +2,7 @@ import { z } from 'zod'
 
 import { robotFFmpegAudio, robotBase, robotUse } from './_instructions-primitives.ts'
 import type { RobotMeta } from './_instructions-primitives.ts'
+import { stackVersions } from '../stackVersions.ts'
 
 export const meta: RobotMeta = {
   allowed_for_url_transform: true,
@@ -13,7 +14,7 @@ export const meta: RobotMeta = {
       artwork_extracted: {
         robot: '/audio/artwork',
         use: ':original',
-        ffmpeg_stack: '{{ stacks.ffmpeg.recommended_version }}',
+        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
       },
     },
   },

src/alphalib/types/robots/audio-concat.ts

@@ -8,6 +8,7 @@ import {
   robotFFmpegAudio,
 } from './_instructions-primitives.ts'
 import type { RobotMeta } from './_instructions-primitives.ts'
+import { stackVersions } from '../stackVersions.ts'
 
 export const meta: RobotMeta = {
   allowed_for_url_transform: false,
@@ -25,7 +26,7 @@ export const meta: RobotMeta = {
             { name: ':original', fields: 'third_audio_file', as: 'audio_3' },
           ],
         },
-        ffmpeg_stack: '{{ stacks.ffmpeg.recommended_version }}',
+        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
       },
     },
   },

src/alphalib/types/robots/audio-encode.ts

@@ -8,6 +8,7 @@ import {
   sampleRateSchema,
 } from './_instructions-primitives.ts'
 import type { RobotMeta } from './_instructions-primitives.ts'
+import { stackVersions } from '../stackVersions.ts'
 
 export const meta: RobotMeta = {
   allowed_for_url_transform: false,
@@ -21,7 +22,7 @@ export const meta: RobotMeta = {
         use: ':original',
         preset: 'mp3',
         bitrate: 256000,
-        ffmpeg_stack: '{{ stacks.ffmpeg.recommended_version }}',
+        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
       },
     },
   },

src/alphalib/types/robots/audio-loop.ts

@@ -8,6 +8,7 @@ import {
   sampleRateSchema,
 } from './_instructions-primitives.ts'
 import type { RobotMeta } from './_instructions-primitives.ts'
+import { stackVersions } from '../stackVersions.ts'
 
 export const meta: RobotMeta = {
   allowed_for_url_transform: false,
@@ -20,13 +21,13 @@ export const meta: RobotMeta = {
         robot: '/audio/loop',
         use: ':original',
         duration: 300,
-        ffmpeg_stack: '{{ stacks.ffmpeg.recommended_version }}',
+        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
       },
     },
   },
   example_code_description: 'Loop uploaded audio to achieve a target duration of 300 seconds:',
   marketing_intro:
-    'Whether you’re producing beats, white-noise, or just empty segments as fillers between audio tracks that you’re to stringing together with [🤖/audio/concat]({{robot_links["/audio/concat"]}}), [🤖/audio/loop]({{robot_links["/audio/loop"]}}) has got your back.',
+    'Whether you’re producing beats, white-noise, or just empty segments as fillers between audio tracks that you’re to stringing together with [🤖/audio/concat](/docs/transcoding/audio-encoding/audio-concat/), [🤖/audio/loop](/docs/transcoding/audio-encoding/audio-loop/) has got your back.',
   minimum_charge: 0,
   output_factor: 0.8,
   override_lvl1: 'Audio Encoding',

src/alphalib/types/robots/audio-merge.ts

@@ -8,6 +8,7 @@ import {
   sampleRateSchema,
 } from './_instructions-primitives.ts'
 import type { RobotMeta } from './_instructions-primitives.ts'
+import { stackVersions } from '../stackVersions.ts'
 
 export const meta: RobotMeta = {
   allowed_for_url_transform: false,
@@ -26,7 +27,7 @@ export const meta: RobotMeta = {
             { name: ':original', fields: 'third_audio_file', as: 'audio' },
           ],
         },
-        ffmpeg_stack: '{{ stacks.ffmpeg.recommended_version }}',
+        ffmpeg_stack: stackVersions.ffmpeg.recommendedVersion,
       },
     },
   },

src/alphalib/types/robots/document-ocr.ts

@@ -26,7 +26,7 @@ export const meta: RobotMeta = {
   extended_description: `
 **Warning:** Transloadit aims to be deterministic, but this <dfn>Robot</dfn> uses third-party AI services. The providers (AWS, GCP) will evolve their models over time, giving different responses for the same input PDFs. Avoid relying on exact responses in your tests and application. [{.alert .alert-warning}]
 
-**Note:** Currently, this <dfn>Robot</dfn> only supports character recognition for PDFs. To use this <dfn>Robot</dfn> with other document formats, use [/document/convert]({{robot_links["/document/convert"]}}) first to convert the document into a PDF. [{.alert .alert-note}]
+**Note:** Currently, this <dfn>Robot</dfn> only supports character recognition for PDFs. To use this <dfn>Robot</dfn> with other document formats, use [/document/convert](/docs/transcoding/document-processing/document-convert/) first to convert the document into a PDF. [{.alert .alert-note}]
 `,
   minimum_charge: 1048576,
   output_factor: 1,

src/alphalib/types/robots/file-filter.ts

@@ -45,7 +45,7 @@ The <dfn>Robot</dfn> has two modes of operation:
 - Constructing conditions out of arrays with 3 members each. For example, \`["\${file.size}", "<=", "720"]\`
 - Writing conditions in JavaScript. For example, \`\${file.size <= 720}\`. See also [Dynamic Evaluation](/docs/topics/dynamic-evaluation/).
 
-Passing JavaScript allows you to implement logic as complex as you wish, however it’s slower than combining arrays of conditions, and will be charged for per invocation via [🤖/script/run]({{robot_links["/script/run"]}}).
+Passing JavaScript allows you to implement logic as complex as you wish, however it’s slower than combining arrays of conditions, and will be charged for per invocation via [🤖/script/run](/docs/transcoding/code-evaluation/script-run/).
 
 ### Conditions as arrays
 
@@ -75,7 +75,7 @@ Examples:
 - \`\${/image/.test(file.mime)}\`
 - \`\${Math.max(file.meta.width, file.meta.height) > 100}\`
 
-As indicated, we charge for this via [🤖/script/run]({{robot_links["/script/run"]}}). See also [Dynamic Evaluation](/docs/topics/dynamic-evaluation/) for more details on allowed syntax and behavior.
+As indicated, we charge for this via [🤖/script/run](/docs/transcoding/code-evaluation/script-run/). See also [Dynamic Evaluation](/docs/topics/dynamic-evaluation/) for more details on allowed syntax and behavior.
 `),
     accepts: z
       .array(

src/alphalib/types/robots/file-serve.ts

@@ -29,15 +29,15 @@ When you want Transloadit to tranform files on the fly, you can use this <dfn>Ro
 
 🤖/file/serve merely acts as the glue layer between our <dfn>Assembly</dfn> engine and serving files over HTTP. It let's you pick the proper result of a series of <dfn>Steps</dfn> via the \`use\` parameter and configure headers on the original content. That is where its responsibilies end, and 🤖/tlcdn/deliver, then takes over to globally distribute this original content across the globe, and make sure that is cached close to your end-users, when they make requests such as <https://my-app.tlcdn.com/resize-img/canoe.jpg?w=500>, another. 🤖/tlcdn/deliver is not a part of your <dfn>Assembly Instructions</dfn>, but it may appear on your invoices as bandwidth charges incur when distributing the cached copies. 🤖/file/serve only charges when the CDN does not have a cached copy and requests to regenerate the original content, which depending on your caching settings could be just once a month, or year, per file/transformation.
 
-While theoretically possible, you could use [🤖/file/serve]({{robot_links["/file/serve"]}}) directly in HTML files, but we strongly recommend against this, because if your site gets popular and the media URL that /file/serve is handling gets hit one million times, that is one million new image resizes. Wrapping it with a CDN (and thanks to the caching that comes with it) makes sure encoding charges stay low, as well as latencies.
+While theoretically possible, you could use [🤖/file/serve](/docs/transcoding/content-delivery/file-serve/) directly in HTML files, but we strongly recommend against this, because if your site gets popular and the media URL that /file/serve is handling gets hit one million times, that is one million new image resizes. Wrapping it with a CDN (and thanks to the caching that comes with it) makes sure encoding charges stay low, as well as latencies.
 
 Also consider configuring caching headers and cache-control directives to control how content is cached and invalidated on the CDN edge servers, balancing between freshness and efficiency.
 
 More information on:
 
 - [Content Delivery](/services/content-delivery/).
-- [🤖/file/serve]({{robot_links["/file/serve"]}}) pricing.
-- [🤖/tlcdn/deliver]({{robot_links["/tlcdn/deliver"]}}) pricing.
+- [🤖/file/serve](/docs/transcoding/content-delivery/file-serve/) pricing.
+- [🤖/tlcdn/deliver](/docs/transcoding/content-delivery/tlcdn-deliver/) pricing.
 - [File Preview Feature](/blog/2024/06/file-preview-with-smart-cdn/) blog post.
 `),
     headers: z.record(z.string()).default({

src/alphalib/types/robots/image-resize.ts

@@ -326,7 +326,6 @@ An array of objects each containing text rules. The following text parameters ar
 "watermarked": {
   "use": "resized",
   "robot": "/image/resize",
-  "imagemagick_stack": "{{stacks.imagemagick.recommended_version}}",
   "text": [
     {
       "text": "© 2018 Transloadit.com",