@telorun/pdf 0.2.0 → 0.3.0

package/README.md

@@ -23,7 +23,7 @@ Built to be language-agnostic and infinitely extensible.
 
 ```bash
 # Reconcile your manifest into a running backend
-$ telo ./examples/hello-api.yaml
+$ telo ./examples/hello-api
 
 {"level":30,"time":1771610393008,"pid":1310178,"hostname":"dev","msg":"Server listening at http://127.0.0.1:8844"}
 ```
@@ -44,146 +44,7 @@ $ telo ./examples/hello-api.yaml
 
 ## Example manifest
 
-Here is an example Telo application that defines a simple HTTP API:
-
-```yaml
-kind: Telo.Application
-metadata:
-  name: feedback
-  version: 1.0.0
-  description: |
-    A complete feedback collection REST API — no code, pure YAML.
-    Persists entries to SQLite and serves them over HTTP.
-imports:
-  Http: std/http-server@0.11.0
-  Sql: std/sql@0.9.0
-targets:
-  - !ref Migrations
-  - !ref Server
----
-# SQLite database — swap driver/host/database for PostgreSQL with zero YAML changes
-kind: Sql.Connection
-metadata:
-  name: Db
-driver: sqlite
-file: ./tmp/feedback.db
----
-# Migrations: applied automatically before the server starts
-kind: Sql.Migrations
-metadata:
-  name: Migrations
-connection: !ref Db
----
-kind: Sql.Migration
-metadata:
-  name: Migration_20260413_182154_CreateFeedback
-version: 20260413_182154_CreateFeedback
-sql: |
-  CREATE TABLE IF NOT EXISTS feedback (
-    id        INTEGER PRIMARY KEY AUTOINCREMENT,
-    text      TEXT    NOT NULL,
-    source    TEXT,
-    score     INTEGER NOT NULL DEFAULT 0,
-    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
-  )
----
-kind: Http.Server
-metadata:
-  name: Server
-baseUrl: http://localhost:8844
-port: 8844
-logger: true
-openapi:
-  info:
-    title: Feedback API
-    version: 1.0.0
-mounts:
-  - path: /v1
-    mount: !ref FeedbackRoutes
----
-kind: Http.Api
-metadata:
-  name: FeedbackRoutes
-routes:
-  # POST /v1/feedback — insert a new entry, score derived from body length heuristic
-  - request:
-      path: /feedback
-      method: POST
-      schema:
-        body:
-          type: object
-          properties:
-            text:
-              type: string
-              minLength: 1
-            source:
-              type: string
-          required: [ text ]
-    handler:
-      kind: Sql.Exec
-      connection: !ref Db
-    inputs:
-      sql: "INSERT INTO feedback (text, source, score) VALUES (?, ?, ?)"
-      bindings:
-        - "${{ request.body.text }}"
-        - "${{ request.body.source }}"
-        - "${{ size(request.body.text) }}"
-    response:
-      - status: 201
-        headers:
-          Content-Type: application/json
-        body:
-          ok: true
-          message: Feedback received
-
-  # GET /v1/feedback — list all entries, newest first
-  - request:
-      path: /feedback
-      method: GET
-    handler:
-      kind: Sql.Select
-      connection: !ref Db
-      from: feedback
-      columns: [ id, text, source, score, created_at ]
-      orderBy:
-        - { column: created_at, direction: desc }
-    response:
-      - status: 200
-        headers:
-          Content-Type: application/json
-        body: "${{ result.rows }}"
-
-  # GET /v1/feedback/{id} — fetch a single entry
-  - request:
-      path: /feedback/{id}
-      method: GET
-      schema:
-        params:
-          type: object
-          properties:
-            id:
-              type: integer
-          required: [ id ]
-    handler:
-      kind: Sql.Select
-      connection: !ref Db
-      from: feedback
-      columns: [ id, text, source, score, created_at ]
-      where:
-        - { column: id, op: "=", value: "${{ request.params.id }}" }
-    response:
-      - status: 200
-        when: "size(result.rows) > 0"
-        headers:
-          Content-Type: application/json
-        body: "${{ result.rows[0] }}"
-      - status: 404
-        headers:
-          Content-Type: application/json
-        body:
-          ok: false
-          message: Not found
-```
+See [examples/](./examples/) for a list of working applications.
 
 ## Status
 

package/dist/form-fields-controller.d.ts

@@ -39,8 +39,4 @@ declare class PdfFormFields implements ResourceInstance<FormFieldsInputs, FormFi
 }
 export declare function register(ctx: ControllerContext): void;
 export declare function create(resource: FormFieldsResource, ctx: ResourceContext): Promise<PdfFormFields>;
-export declare const schema: {
-    type: string;
-    additionalProperties: boolean;
-};
 export {};

package/dist/form-fields-controller.js

@@ -14,10 +14,10 @@ class PdfFormFields {
     }
     async invoke(inputs) {
         const label = `Pdf.FormFields "${this.resource.metadata.name}"`;
+        // An `inputs.scale` is declared on `inputType` with `exclusiveMinimum: 0` and
+        // enforced by the kernel's contract binding; the resource-level fallback is
+        // checked by the config schema. Neither needs re-checking here.
         const scale = inputs?.scale ?? this.resource.scale ?? 1;
-        if (typeof scale !== "number" || !(scale > 0)) {
-            throw new InvokeError("ERR_INVALID_INPUT", `${label}: 'scale' must be a positive number; got ${scale}.`);
-        }
         const data = inputs?.data;
         if (!(data instanceof Uint8Array)) {
             throw new InvokeError("ERR_INVALID_INPUT", `${label}: 'data' must be a Uint8Array of PDF bytes; got ${typeof data}.`);
@@ -78,7 +78,3 @@ export function register(ctx) { }
 export async function create(resource, ctx) {
     return new PdfFormFields(resource);
 }
-export const schema = {
-    type: "object",
-    additionalProperties: true,
-};

package/dist/rasterizer-controller.d.ts

@@ -36,8 +36,4 @@ declare class PdfRasterizer implements ResourceInstance<RasterizerInputs, Raster
 }
 export declare function register(ctx: ControllerContext): void;
 export declare function create(resource: RasterizerResource, ctx: ResourceContext): Promise<PdfRasterizer>;
-export declare const schema: {
-    type: string;
-    additionalProperties: boolean;
-};
 export {};

package/dist/rasterizer-controller.js

@@ -32,10 +32,11 @@ class PdfRasterizer {
         if (!(data instanceof Uint8Array)) {
             throw new InvokeError("ERR_INVALID_INPUT", `Pdf.Rasterizer "${name}": 'data' must be a Uint8Array of PDF bytes; got ${typeof data}.`);
         }
+        // `page` is declared on `inputType` as an integer with `minimum: 1` and
+        // enforced by the kernel's contract binding, so only the range check the
+        // schema cannot express — page vs. the document's actual page count — is
+        // still this controller's to make (below).
         const pageNumber = inputs.page ?? 1;
-        if (!Number.isInteger(pageNumber) || pageNumber < 1) {
-            throw new InvokeError("ERR_INVALID_INPUT", `Pdf.Rasterizer "${name}": 'page' must be a positive integer; got ${pageNumber}.`);
-        }
         const task = loadPdf(data);
         try {
             const doc = await task.promise.catch((err) => {
@@ -109,7 +110,3 @@ export function register(ctx) { }
 export async function create(resource, ctx) {
     return new PdfRasterizer(resource);
 }
-export const schema = {
-    type: "object",
-    additionalProperties: true,
-};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/pdf",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "PDF primitives — rasterize pages to PNG images and author editable AcroForm fields.",
   "keywords": [
     "telo",
@@ -47,7 +47,7 @@
   "devDependencies": {
     "@types/node": "^20.0.0",
     "typescript": "^5.0.0",
-    "@telorun/sdk": "0.26.0"
+    "@telorun/sdk": "0.61.0"
   },
   "peerDependencies": {
     "@telorun/sdk": "*"

package/src/form-fields-controller.ts

@@ -41,13 +41,10 @@ class PdfFormFields implements ResourceInstance<FormFieldsInputs, FormFieldsOutp
 
   async invoke(inputs: FormFieldsInputs): Promise<FormFieldsOutputs> {
     const label = `Pdf.FormFields "${this.resource.metadata.name}"`;
+    // An `inputs.scale` is declared on `inputType` with `exclusiveMinimum: 0` and
+    // enforced by the kernel's contract binding; the resource-level fallback is
+    // checked by the config schema. Neither needs re-checking here.
     const scale = inputs?.scale ?? this.resource.scale ?? 1;
-    if (typeof scale !== "number" || !(scale > 0)) {
-      throw new InvokeError(
-        "ERR_INVALID_INPUT",
-        `${label}: 'scale' must be a positive number; got ${scale}.`,
-      );
-    }
     const data = inputs?.data;
     if (!(data instanceof Uint8Array)) {
       throw new InvokeError(
@@ -142,7 +139,3 @@ export async function create(
   return new PdfFormFields(resource);
 }
 
-export const schema = {
-  type: "object",
-  additionalProperties: true,
-};

package/src/rasterizer-controller.ts

@@ -59,13 +59,11 @@ class PdfRasterizer implements ResourceInstance<RasterizerInputs, RasterizerOutp
         `Pdf.Rasterizer "${name}": 'data' must be a Uint8Array of PDF bytes; got ${typeof data}.`,
       );
     }
+    // `page` is declared on `inputType` as an integer with `minimum: 1` and
+    // enforced by the kernel's contract binding, so only the range check the
+    // schema cannot express — page vs. the document's actual page count — is
+    // still this controller's to make (below).
     const pageNumber = inputs.page ?? 1;
-    if (!Number.isInteger(pageNumber) || pageNumber < 1) {
-      throw new InvokeError(
-        "ERR_INVALID_INPUT",
-        `Pdf.Rasterizer "${name}": 'page' must be a positive integer; got ${pageNumber}.`,
-      );
-    }
 
     const task = loadPdf(data);
     try {
@@ -166,7 +164,3 @@ export async function create(
   return new PdfRasterizer(resource);
 }
 
-export const schema = {
-  type: "object",
-  additionalProperties: true,
-};