@oliphaunt/wasix-ts 0.1.0 → 0.2.1

package/lib/icu-descriptor.js

@@ -1,92 +0,0 @@
-import { requireAssetSource, requireExactObject, requireSafeRelativeAssetPath, requireSha256, requireSize, requireVersion, serializeAssetSource, } from './descriptor-validation.js';
-const DESCRIPTOR_FIELDS = [
-    'clusterSeedArchive',
-    'clusterSeedManifest',
-    'compatibility',
-    'dataArchive',
-    'product',
-    'runtime',
-    'schema',
-    'version',
-];
-const COMPATIBILITY_FIELDS = [
-    'compatibilityKey',
-    'dataForm',
-    'dataTreeSha256',
-    'dataVersion',
-    'physicalFormat',
-    'postgresMajor',
-    'runtimeProduct',
-    'runtimeVersion',
-];
-const ARCHIVE_FIELDS = ['archive', 'sha256', 'size', 'source'];
-const MANIFEST_FIELDS = ['sha256', 'size', 'source'];
-/** Validate an explicitly imported ICU carrier before bytes cross a worker boundary. */
-export function serializeWasixIcuDescriptor(value) {
-    validateWasixIcuDescriptor(value, 'WASIX ICU descriptor');
-    return {
-        schema: value.schema,
-        runtime: value.runtime,
-        product: value.product,
-        version: value.version,
-        compatibility: { ...value.compatibility },
-        dataArchive: serializeArchive(value.dataArchive),
-        clusterSeedArchive: serializeArchive(value.clusterSeedArchive),
-        clusterSeedManifest: serializeManifest(value.clusterSeedManifest),
-    };
-}
-function validateWasixIcuDescriptor(value, label) {
-    const descriptor = requireExactObject(value, DESCRIPTOR_FIELDS, label);
-    if (descriptor.schema !== 'oliphaunt-wasix-icu-v1')
-        throw new Error(`${label} has unsupported schema`);
-    if (descriptor.runtime !== 'wasix')
-        throw new Error(`${label} must target runtime 'wasix'`);
-    if (descriptor.product !== 'oliphaunt-icu')
-        throw new Error(`${label} product must be 'oliphaunt-icu'`);
-    requireVersion(descriptor.version, `${label} version`);
-    const compatibility = requireExactObject(descriptor.compatibility, COMPATIBILITY_FIELDS, `${label} compatibility`);
-    if (compatibility.runtimeProduct !== 'liboliphaunt-wasix' ||
-        compatibility.postgresMajor !== '18' ||
-        compatibility.physicalFormat !== 'wasix-pg18-v1' ||
-        compatibility.compatibilityKey !== 'wasix-pg18-datum32-v1' ||
-        compatibility.dataVersion !== '76.1' ||
-        compatibility.dataForm !== 'files-le') {
-        throw new Error(`${label} has an incompatible WASIX/ICU identity`);
-    }
-    requireVersion(compatibility.runtimeVersion, `${label} compatible runtime version`);
-    requireSha256(compatibility.dataTreeSha256, `${label} ICU data tree SHA-256`);
-    validateArchive(descriptor.dataArchive, `${label} ICU data archive`);
-    validateArchive(descriptor.clusterSeedArchive, `${label} ICU cluster seed archive`);
-    validateManifest(descriptor.clusterSeedManifest, `${label} ICU cluster seed manifest`);
-    if (descriptor.dataArchive.archive === descriptor.clusterSeedArchive.archive) {
-        throw new Error(`${label} ICU data and cluster seed archives must have distinct paths`);
-    }
-}
-function validateArchive(value, label) {
-    const archive = requireExactObject(value, ARCHIVE_FIELDS, label);
-    requireSafeRelativeAssetPath(archive.archive, `${label} path`);
-    requireSha256(archive.sha256, `${label} SHA-256`);
-    const size = requireSize(archive.size, `${label} size`);
-    requireAssetSource(archive.source, `${label} source`, size);
-}
-function validateManifest(value, label) {
-    const manifest = requireExactObject(value, MANIFEST_FIELDS, label);
-    requireSha256(manifest.sha256, `${label} SHA-256`);
-    const size = requireSize(manifest.size, `${label} size`);
-    requireAssetSource(manifest.source, `${label} source`, size);
-}
-function serializeArchive(archive) {
-    return {
-        archive: archive.archive,
-        sha256: archive.sha256,
-        size: archive.size,
-        source: serializeAssetSource(archive.source),
-    };
-}
-function serializeManifest(manifest) {
-    return {
-        sha256: manifest.sha256,
-        size: manifest.size,
-        source: serializeAssetSource(manifest.source),
-    };
-}

package/lib/protocol.d.ts

@@ -1 +0,0 @@
-export * from '@oliphaunt/js-core/protocol';

package/lib/protocol.js

@@ -1 +0,0 @@
-export * from '@oliphaunt/js-core/protocol';

package/lib/query.d.ts

@@ -1 +0,0 @@
-export * from '@oliphaunt/js-core/query';

package/lib/query.js

@@ -1 +0,0 @@
-export * from '@oliphaunt/js-core/query';

package/node_modules/@oliphaunt/js-core/README.md

@@ -1,7 +0,0 @@
-# Shared JavaScript Core
-
-Canonical TypeScript helpers shared by the JavaScript, React Native, and WASIX
-TypeScript SDKs through the private `@oliphaunt/js-core` workspace package.
-
-Moon builds its ESM and CommonJS exports once. Published SDKs bundle that
-minimal private package so registry consumers do not need another dependency.

package/node_modules/@oliphaunt/js-core/dist/commonjs/protocol.d.ts

@@ -1 +0,0 @@
-export declare function simpleQuery(sql: string): Uint8Array;

package/node_modules/@oliphaunt/js-core/dist/commonjs/protocol.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.simpleQuery = simpleQuery;
-const encoder = new TextEncoder();
-function simpleQuery(sql) {
-    if (sql.includes('\0')) {
-        throw new Error('simple query SQL must not contain NUL bytes');
-    }
-    const body = encoder.encode(sql);
-    const packet = new Uint8Array(body.length + 6);
-    packet[0] = 'Q'.charCodeAt(0);
-    writeI32(packet, 1, body.length + 5);
-    packet.set(body, 5);
-    packet[packet.length - 1] = 0;
-    return packet;
-}
-function writeI32(bytes, offset, value) {
-    bytes[offset] = (value >>> 24) & 0xff;
-    bytes[offset + 1] = (value >>> 16) & 0xff;
-    bytes[offset + 2] = (value >>> 8) & 0xff;
-    bytes[offset + 3] = value & 0xff;
-}

package/node_modules/@oliphaunt/js-core/dist/commonjs/query.d.ts

@@ -1,255 +0,0 @@
-import { simpleQuery } from './protocol.js';
-export type QueryBinaryInput = ArrayBuffer | ArrayBufferView | Uint8Array;
-export type ByteInput = QueryBinaryInput | ReadonlyArray<number>;
-/** Stable PostgreSQL OIDs used by the built-in JavaScript codecs. */
-export declare const postgresOids: Readonly<{
-    readonly bool: 16;
-    readonly bytea: 17;
-    readonly char: 18;
-    readonly name: 19;
-    readonly int8: 20;
-    readonly int2: 21;
-    readonly int4: 23;
-    readonly text: 25;
-    readonly oid: 26;
-    readonly json: 114;
-    readonly xml: 142;
-    readonly float4: 700;
-    readonly float8: 701;
-    readonly unknown: 705;
-    readonly bpchar: 1042;
-    readonly varchar: 1043;
-    readonly date: 1082;
-    readonly time: 1083;
-    readonly timestamp: 1114;
-    readonly timestamptz: 1184;
-    readonly interval: 1186;
-    readonly timetz: 1266;
-    readonly numeric: 1700;
-    readonly uuid: 2950;
-    readonly jsonb: 3802;
-    readonly boolArray: 1000;
-    readonly byteaArray: 1001;
-    readonly charArray: 1002;
-    readonly nameArray: 1003;
-    readonly int2Array: 1005;
-    readonly int4Array: 1007;
-    readonly textArray: 1009;
-    readonly bpcharArray: 1014;
-    readonly varcharArray: 1015;
-    readonly int8Array: 1016;
-    readonly float4Array: 1021;
-    readonly float8Array: 1022;
-    readonly oidArray: 1028;
-    readonly dateArray: 1182;
-    readonly timeArray: 1183;
-    readonly timestampArray: 1115;
-    readonly timestamptzArray: 1185;
-    readonly intervalArray: 1187;
-    readonly numericArray: 1231;
-    readonly timetzArray: 1270;
-    readonly jsonArray: 199;
-    readonly xmlArray: 143;
-    readonly uuidArray: 2951;
-    readonly jsonbArray: 3807;
-}>;
-declare const encodedQueryParameterBrand: unique symbol;
-type EncodedQueryParameterBrand = {
-    readonly [encodedQueryParameterBrand]: true;
-};
-export type TextQueryParameter = Readonly<EncodedQueryParameterBrand & {
-    format: 'text';
-    value: string;
-    typeOid?: number;
-}>;
-export type BinaryQueryParameter = Readonly<EncodedQueryParameterBrand & {
-    format: 'binary';
-    value: QueryBinaryInput;
-    typeOid?: number;
-}>;
-export type NullQueryParameter = Readonly<EncodedQueryParameterBrand & {
-    format: 'null';
-    typeOid: number;
-}>;
-export type EncodedQueryParameter = TextQueryParameter | BinaryQueryParameter | NullQueryParameter;
-export type QueryParam = null | string | number | bigint | boolean | Date | QueryBinaryInput | Readonly<Record<string, unknown>> | ReadonlyArray<unknown> | EncodedQueryParameter;
-export type QueryParameterEncoder = (value: QueryParam, typeOid: number) => EncodedQueryParameter;
-export type QueryFormat = 'text' | 'binary' | {
-    code: number;
-    kind: 'other';
-};
-export type QueryField = {
-    name: string;
-    tableOid: number;
-    tableAttribute: number;
-    typeOid: number;
-    typeSize: number;
-    typeModifier: number;
-    format: QueryFormat;
-};
-export type RawQueryRow = {
-    values: Array<Uint8Array | null>;
-    text(column: number): string | null;
-};
-export type PostgresNotice = {
-    severity?: string;
-    localizedSeverity?: string;
-    nonlocalizedSeverity?: string;
-    sqlstate?: string;
-    message: string;
-    detail?: string;
-    hint?: string;
-    position?: string;
-    internalPosition?: string;
-    internalQuery?: string;
-    whereText?: string;
-    schemaName?: string;
-    tableName?: string;
-    columnName?: string;
-    dataTypeName?: string;
-    constraintName?: string;
-    file?: string;
-    line?: string;
-    routine?: string;
-    fields: PostgresErrorField[];
-};
-export type RawQueryResult = {
-    kind: 'command' | 'rows';
-    fields: QueryField[];
-    rows: RawQueryRow[];
-    commandTag?: string;
-    rowCount: number | null;
-    notices: PostgresNotice[];
-    getText(row: number, column: string): string | null;
-};
-export type QueryValue = null | string | number | boolean | Uint8Array | QueryValue[] | {
-    [key: string]: unknown;
-};
-export type QueryObjectRow<Value = QueryValue> = Record<string, Value>;
-export type QueryArrayRow<Value = QueryValue> = Value[];
-export type QueryResult<Row = QueryObjectRow> = {
-    kind: 'command' | 'rows';
-    fields: QueryField[];
-    rows: Row[];
-    commandTag?: string;
-    rowCount: number | null;
-    notices: PostgresNotice[];
-};
-export type QueryValueDecoder<Value = unknown> = (value: string, field: QueryField) => Value;
-export type QueryDecoderMap = Readonly<Record<number, QueryValueDecoder>>;
-export type QueryRowMode = 'object' | 'array';
-export type QueryOptions<RowMode extends QueryRowMode = QueryRowMode, Decoders extends QueryDecoderMap | undefined = QueryDecoderMap | undefined> = Readonly<{
-    rowMode?: RowMode;
-    valueMode?: 'decoded' | 'text';
-    decoders?: Decoders;
-    encoders?: Readonly<Record<number, QueryParameterEncoder>>;
-}>;
-type QueryModeFromOptions<Options> = Options extends {
-    readonly rowMode?: infer Mode;
-} ? Extract<Mode, QueryRowMode> extends never ? 'object' : Extract<Mode, QueryRowMode> : 'object';
-type QueryDecoderOutput<Options> = Options extends {
-    readonly decoders?: infer Decoders;
-} ? Decoders extends QueryDecoderMap ? Decoders[keyof Decoders] extends QueryValueDecoder<infer Value> ? Value : never : never : never;
-type QueryRowForMode<Mode extends QueryRowMode, Value> = Mode extends 'array' ? QueryArrayRow<Value> : QueryObjectRow<Value>;
-/** Infer the runtime row shape from `rowMode` and custom decoder return types. */
-export type InferQueryRow<Options, ExplicitRow = never> = [ExplicitRow] extends [never] ? QueryRowForMode<QueryModeFromOptions<Options>, QueryValue | QueryDecoderOutput<Options>> : ExplicitRow;
-export type ParameterOptions = Readonly<{
-    encoders?: Readonly<Record<number, QueryParameterEncoder>>;
-}>;
-export type CommandResult = {
-    commandTag?: string;
-    rowCount: number | null;
-    notices: PostgresNotice[];
-};
-export type ExecResult<Row = QueryObjectRow> = {
-    statements: QueryResult<Row>[];
-    notices: PostgresNotice[];
-};
-export type DescribeResult = {
-    parameterTypeOids: number[];
-    fields?: QueryField[];
-    notices: PostgresNotice[];
-};
-export type TransactionStatus = 'idle' | 'transaction' | 'failed';
-export { simpleQuery };
-export type PostgresErrorField = {
-    code: number;
-    value: string;
-};
-export declare class PostgresError extends Error {
-    readonly severity?: string;
-    readonly localizedSeverity?: string;
-    readonly nonlocalizedSeverity?: string;
-    readonly sqlstate?: string;
-    readonly detail?: string;
-    readonly hint?: string;
-    readonly position?: string;
-    readonly internalPosition?: string;
-    readonly internalQuery?: string;
-    readonly whereText?: string;
-    readonly schemaName?: string;
-    readonly tableName?: string;
-    readonly columnName?: string;
-    readonly dataTypeName?: string;
-    readonly constraintName?: string;
-    readonly file?: string;
-    readonly line?: string;
-    readonly routine?: string;
-    readonly fields: PostgresErrorField[];
-    readonly notices: PostgresNotice[];
-    constructor(fields: PostgresErrorField[], notices?: PostgresNotice[]);
-}
-/** @internal Preserve query-scoped notices on caller codec failures. */
-export declare function errorWithNotices(error: unknown, notices: ReadonlyArray<PostgresNotice>): unknown;
-export declare function text(value: string | number | bigint | boolean | Date, typeOid?: number): TextQueryParameter;
-export declare function binary(value: QueryBinaryInput, typeOid?: number): BinaryQueryParameter;
-export declare function typedNull(typeOid: number): NullQueryParameter;
-export declare function json(value: unknown, typeOid?: number): TextQueryParameter;
-export declare function array(values: ReadonlyArray<unknown>, typeOid?: number): TextQueryParameter;
-export type QueryPlan = Readonly<{
-    kind: 'complete';
-    input: Uint8Array;
-}> | Readonly<{
-    kind: 'describe';
-    input: Uint8Array;
-    bind(parameterTypeOids: ReadonlyArray<number>): Uint8Array;
-}>;
-export declare function planQuery(sql: string, parameters?: ReadonlyArray<QueryParam>, options?: ParameterOptions): QueryPlan;
-/** Encode a one-exchange query. Untyped values require planQuery() instead. */
-export declare function extendedQuery(sql: string, parameters: ReadonlyArray<QueryParam>, options?: ParameterOptions): Uint8Array;
-export declare function describeQuery(sql: string, parameterTypeOids?: ReadonlyArray<number>): Uint8Array;
-export declare function responseTransactionStatus(value: object): TransactionStatus | undefined;
-/**
- * Validate the complete backend framing and return the one terminal
- * ReadyForQuery status without interpreting result values.
- *
- * Structured clients call this immediately after transport completion so a
- * custom decoder or higher-level result assertion cannot obscure whether the
- * physical PostgreSQL session reached a reusable boundary.
- */
-export declare function inspectReadyForQuery(bytes: Uint8Array): TransactionStatus;
-/**
- * Validate a structured callback-transaction response before high-level
- * parsing can discard earlier command tags after a later ErrorResponse.
- */
-export declare function inspectManagedTransactionResponse(bytes: Uint8Array): TransactionStatus;
-export declare function parseQueryRawResponse(bytes: Uint8Array): RawQueryResult;
-export declare function parseSimpleQueryRawResponse(bytes: Uint8Array): RawQueryResult;
-export declare function decodeQueryResult<Row = never, const Options extends QueryOptions = {}>(raw: RawQueryResult, options?: Options & QueryOptions): QueryResult<InferQueryRow<Options, Row>>;
-export declare function parseExecResponse<Row = never, const Options extends Omit<QueryOptions, 'encoders'> = {}>(bytes: Uint8Array, options?: Options & Omit<QueryOptions, 'encoders'>): ExecResult<InferQueryRow<Options, Row>>;
-export declare function parseCommandResponse(bytes: Uint8Array): CommandResult;
-export declare function parseDescribeResponse(bytes: Uint8Array): DescribeResult;
-export declare function assertSuccessfulQueryResponse(bytes: Uint8Array): void;
-export declare function assertNoTopLevelCopy(sql: string): void;
-/**
- * Reject transaction commands whose response boundary cannot prove that the
- * callback still owns the transaction it started. PostgreSQL reports both
- * `ROLLBACK TO SAVEPOINT` and `ROLLBACK AND CHAIN` as command tag `ROLLBACK`
- * with ReadyForQuery status `transaction`, so the latter must be rejected
- * before execution rather than inferred from the backend response.
- */
-export declare function assertNoTransactionChain(sql: string): void;
-export declare function structuredSimpleQuery(sql: string): Uint8Array;
-export declare function containsTopLevelCopy(sql: string): boolean;
-export declare function containsTransactionChain(sql: string): boolean;
-export declare function toUint8Array(input: ByteInput): Uint8Array;