@attentionform/astra 0.0.0-stage → 0.1.0

package/dist/packages/ooxml-validator/src/protocol.d.ts

@@ -0,0 +1,30 @@
+import type { OfficeVersion, ValidationError } from './types.js';
+export interface WorkerRequestHeader {
+    id: number;
+    op?: 'validate' | 'ping' | 'version' | 'shutdown' | string;
+    kind?: 'docx' | 'pptx' | 'xlsx' | string;
+    office?: OfficeVersion | string;
+    size?: number;
+    maxErrors?: number;
+    maxDocBytes?: number;
+}
+export interface WorkerResponse {
+    id: number | null;
+    ok: boolean;
+    pong?: boolean;
+    sdkVersion?: string;
+    office?: string;
+    durationMs?: number;
+    errorCount?: number;
+    truncated?: boolean;
+    fatal?: boolean;
+    error?: string;
+    errors?: ValidationError[];
+}
+export declare function encodeRequest(header: WorkerRequestHeader, bytes?: Uint8Array | Buffer): Buffer;
+export declare class JsonLineDecoder {
+    private decoder;
+    private buffer;
+    push(chunk: Buffer | Uint8Array): WorkerResponse[];
+    end(): WorkerResponse[];
+}

package/dist/packages/ooxml-validator/src/resolve-binary.d.ts

@@ -0,0 +1,5 @@
+export declare function resolveBinaryDetails(): {
+    binaryPath: string;
+    platformPackage: string;
+};
+export declare function resolveEmbeddedBinary(): string;

package/dist/packages/ooxml-validator/src/types.d.ts

@@ -0,0 +1,65 @@
+export declare const OFFICE_VERSIONS: readonly ["Office2007", "Office2010", "Office2013", "Office2016", "Office2019", "Office2021", "Microsoft365"];
+export type OfficeVersion = (typeof OFFICE_VERSIONS)[number];
+export interface ErrorNode {
+    localName?: string | null;
+    namespaceUri?: string | null;
+}
+export type ValidationErrorClass = 'schema' | 'semantic' | 'markup-compat' | 'package' | 'exception' | string;
+export interface ValidationError {
+    /** Human-readable description of the problem. */
+    description?: string | null;
+    /** Package part the error was found in, e.g. `/word/document.xml`. `null` for `errorType: 'Exception'`. */
+    path?: string | null;
+    /** XPath of the offending element. `null` for `errorType: 'Exception'`. */
+    xPath?: string | null;
+    /** Open XML SDK error id, e.g. `Sch_UnexpectedElementContentExpectingComplex`. `null` for `errorType: 'Exception'`. */
+    id?: string | null;
+    /** `Schema`, `Semantic`, `Package`, `MarkupCompatibility`, or `Exception` when the file could not be opened at all. */
+    errorType?: string | null;
+    /** Part URI string (e.g. `/word/document.xml`). */
+    part?: string | null;
+    /** Error classification: 'schema' | 'semantic' | 'markup-compat' | 'package' | 'exception'. */
+    class?: ValidationErrorClass | null;
+    /** Offending XML element information when present. */
+    node?: ErrorNode | null;
+    /** Related XML element information when present. */
+    relatedNode?: ErrorNode | null;
+    [key: string]: unknown;
+}
+export interface ValidationResult {
+    file: string;
+    ok: boolean;
+    errors: ValidationError[];
+    sdkVersion?: string;
+    office?: string;
+    durationMs?: number;
+    truncated?: boolean;
+    errorCount?: number;
+    [key: string]: unknown;
+}
+export interface ValidateOptions {
+    /** Open XML schema version to validate against. Defaults to `Microsoft365` for one-shot, `Office2019` for buffer. */
+    officeVersion?: OfficeVersion;
+    maxErrors?: number;
+    timeoutMs?: number;
+    maxDocBytes?: number;
+}
+export interface ValidatorPoolOptions {
+    workers?: number;
+    recycleAfter?: number;
+    timeoutMs?: number;
+    maxDocBytes?: number;
+    maxErrors?: number;
+}
+export interface BackendInfo {
+    platformPackage: string;
+    binaryPath: string;
+    sdkVersion: string;
+    binarySha256: string;
+    workerSupported: boolean;
+}
+export interface ValidatorInstance {
+    validate(bytes: Buffer | Uint8Array, opts?: ValidateOptions): Promise<ValidationResult>;
+    validateFile(path: string, opts?: ValidateOptions): Promise<ValidationResult>;
+    close(): Promise<void>;
+}

package/dist/packages/ooxml-validator/src/worker-client.d.ts

@@ -0,0 +1,38 @@
+import { type WorkerRequestHeader, type WorkerResponse } from './protocol.js';
+import type { ValidatorPoolOptions } from './types.js';
+export declare class WorkerClient {
+    private binaryPath;
+    private recycleAfter;
+    private timeoutMs;
+    private maxDocBytes;
+    private maxErrors;
+    private child;
+    private liveChildren;
+    private queue;
+    private current;
+    private nextId;
+    private requestsHandled;
+    private closed;
+    private _spawnCount;
+    private _spawnedPids;
+    constructor(opts?: ValidatorPoolOptions & {
+        binaryPath?: string;
+    });
+    get pid(): number | undefined;
+    get spawnCount(): number;
+    get spawnedPids(): number[];
+    private ensureWorker;
+    private refChild;
+    private unrefChild;
+    send(header: Omit<WorkerRequestHeader, 'id'>, bytes?: Uint8Array | Buffer, overrideTimeoutMs?: number): Promise<WorkerResponse>;
+    private processQueue;
+    private handleResponse;
+    private handleTimeout;
+    private handleWriteError;
+    private handleProcessError;
+    private handleProcessExit;
+    private retryOrReject;
+    private recycleWorker;
+    private killWorker;
+    close(): Promise<void>;
+}

package/package.json

@@ -1,6 +1,72 @@
 {
   "name": "@attentionform/astra",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Command-line tool for OOXML (.docx) document engineering",
+  "main": "dist/cli.js",
+  "types": "dist/packages/cli/src/cli.d.ts",
+  "bin": {
+    "astra": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE",
+    "!dist/packages/engine",
+    "!dist/**/*.map"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "BUSL-1.1",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Attentionform/astra.git",
+    "directory": "packages/cli"
+  },
+  "keywords": [
+    "cli",
+    "astra",
+    "ooxml",
+    "docx",
+    "word",
+    "terminal",
+    "document",
+    "automation"
+  ],
+  "type": "commonjs",
+  "scripts": {
+    "build": "node ../../scripts/check-adm-zip-imports.mjs && tsc --noEmit -p tsconfig.json && esbuild src/cli.ts --bundle --packages=external --platform=node --target=node22 --format=cjs --outfile=dist/cli.js --log-level=warning && tsc -p tsconfig.dts.json && node -e \"require('fs').chmodSync('dist/cli.js', 0o755)\"",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run",
+    "start": "node dist/cli.js",
+    "adm-zip-gate": "node ../../scripts/check-adm-zip-imports.mjs"
+  },
+  "dependencies": {
+    "@attentionform/astra-engine": "^0.1.0",
+    "@attentionform/ooxml-validator": "^0.1.0",
+    "@xmldom/xmldom": "0.8.15",
+    "adm-zip": "0.6.1",
+    "isomorphic-git": "^1.25.0",
+    "marked": "18.0.5",
+    "p-limit": "^3.1.0",
+    "zod": "4.6.7"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "esbuild": "^0.25.12",
+    "typescript": "^5.2.2",
+    "vitest": "^4.1.7"
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "homepage": "https://attentionform.com",
+  "bugs": {
+    "url": "https://github.com/Attentionform/astra/issues"
+  },
+  "author": {
+    "name": "Attentionform",
+    "url": "https://attentionform.com"
+  }
+}