@wp-typia/project-tools 0.23.1 → 0.24.0

package/dist/runtime/cli-add-workspace-rest-source-emitters.js

@@ -1,666 +1,8 @@
-import { quoteTsString, } from "./cli-add-shared.js";
-import { buildManualRestContractEndpointManifest, buildRestResourceEndpointManifest, } from "./rest-resource-artifacts.js";
-import { toPascalCase, toTitleCase } from "./string-case.js";
-function indentMultiline(source, prefix) {
-    return source
-        .split("\n")
-        .map((line) => `${prefix}${line}`)
-        .join("\n");
-}
 /**
- * Build a generated REST resource config entry for `scripts/block-config.ts`.
+ * Compatibility facade for REST workspace source emitters.
  *
- * @param options REST resource metadata. `restResourceSlug`, `namespace`, and
- * `methods` are required; `controllerClass`, `controllerExtends`,
- * `permissionCallback`, and `routePattern` opt into generated controller,
- * permission, and item-route escape hatches.
- * @returns TypeScript object literal source for one generated REST resource entry.
+ * Keep the public runtime import path stable while generated-resource and
+ * manual-contract emitters live in focused modules.
  */
-export function buildRestResourceConfigEntry(options) {
-    const pascalCase = toPascalCase(options.restResourceSlug);
-    const title = toTitleCase(options.restResourceSlug);
-    const manifest = buildRestResourceEndpointManifest({
-        namespace: options.namespace,
-        pascalCase,
-        ...(options.routePattern ? { routePattern: options.routePattern } : {}),
-        slugKebabCase: options.restResourceSlug,
-        title,
-    }, options.methods);
-    return [
-        "\t{",
-        `\t\tapiFile: ${quoteTsString(`src/rest/${options.restResourceSlug}/api.ts`)},`,
-        ...(options.controllerClass
-            ? [`\t\tcontrollerClass: ${quoteTsString(options.controllerClass)},`]
-            : []),
-        ...(options.controllerExtends
-            ? [`\t\tcontrollerExtends: ${quoteTsString(options.controllerExtends)},`]
-            : []),
-        `\t\tclientFile: ${quoteTsString(`src/rest/${options.restResourceSlug}/api-client.ts`)},`,
-        `\t\tdataFile: ${quoteTsString(`src/rest/${options.restResourceSlug}/data.ts`)},`,
-        `\t\tmethods: [ ${options.methods.map((method) => quoteTsString(method)).join(", ")} ],`,
-        `\t\tnamespace: ${quoteTsString(options.namespace)},`,
-        `\t\topenApiFile: ${quoteTsString(`src/rest/${options.restResourceSlug}/api.openapi.json`)},`,
-        ...(options.permissionCallback
-            ? [`\t\tpermissionCallback: ${quoteTsString(options.permissionCallback)},`]
-            : []),
-        `\t\tphpFile: ${quoteTsString(`inc/rest/${options.restResourceSlug}.php`)},`,
-        "\t\trestManifest: defineEndpointManifest(",
-        indentMultiline(JSON.stringify(manifest, null, "\t"), "\t\t\t"),
-        "\t\t),",
-        ...(options.routePattern
-            ? [`\t\troutePattern: ${quoteTsString(options.routePattern)},`]
-            : []),
-        `\t\tslug: ${quoteTsString(options.restResourceSlug)},`,
-        `\t\ttypesFile: ${quoteTsString(`src/rest/${options.restResourceSlug}/api-types.ts`)},`,
-        `\t\tvalidatorsFile: ${quoteTsString(`src/rest/${options.restResourceSlug}/api-validators.ts`)},`,
-        "\t},",
-    ].join("\n");
-}
-/**
- * Build the `REST_RESOURCES` config entry appended for a manual REST contract.
- *
- * @param options Manual contract file, route, type, and auth metadata.
- * @param options.auth Auth intent stored in the endpoint manifest.
- * @param options.bodyTypeName Optional exported body type name.
- * @param options.method Uppercase HTTP method for the external route.
- * @param options.namespace REST namespace such as `vendor/v1`.
- * @param options.pathPattern Route pattern relative to the namespace.
- * @param options.queryTypeName Exported query type name.
- * @param options.responseTypeName Exported response type name.
- * @param options.restResourceSlug Normalized workspace REST contract slug.
- * @returns A TypeScript object literal string for `scripts/block-config.ts`.
- */
-export function buildManualRestContractConfigEntry(options) {
-    const pascalCase = toPascalCase(options.restResourceSlug);
-    const title = toTitleCase(options.restResourceSlug);
-    const manifest = buildManualRestContractEndpointManifest({
-        auth: options.auth,
-        ...(options.bodyTypeName ? { bodyTypeName: options.bodyTypeName } : {}),
-        method: options.method,
-        namespace: options.namespace,
-        pascalCase,
-        pathPattern: options.pathPattern,
-        queryTypeName: options.queryTypeName,
-        responseTypeName: options.responseTypeName,
-        slugKebabCase: options.restResourceSlug,
-        title,
-    });
-    return [
-        "\t{",
-        `\t\tapiFile: ${quoteTsString(`src/rest/${options.restResourceSlug}/api.ts`)},`,
-        `\t\tauth: ${quoteTsString(options.auth)},`,
-        ...(options.bodyTypeName
-            ? [`\t\tbodyTypeName: ${quoteTsString(options.bodyTypeName)},`]
-            : []),
-        `\t\tclientFile: ${quoteTsString(`src/rest/${options.restResourceSlug}/api-client.ts`)},`,
-        ...(options.controllerClass
-            ? [`\t\tcontrollerClass: ${quoteTsString(options.controllerClass)},`]
-            : []),
-        ...(options.controllerExtends
-            ? [`\t\tcontrollerExtends: ${quoteTsString(options.controllerExtends)},`]
-            : []),
-        `\t\tmethod: ${quoteTsString(options.method)},`,
-        "\t\tmethods: [],",
-        "\t\tmode: 'manual',",
-        `\t\tnamespace: ${quoteTsString(options.namespace)},`,
-        `\t\topenApiFile: ${quoteTsString(`src/rest/${options.restResourceSlug}/api.openapi.json`)},`,
-        `\t\tpathPattern: ${quoteTsString(options.pathPattern)},`,
-        ...(options.permissionCallback
-            ? [`\t\tpermissionCallback: ${quoteTsString(options.permissionCallback)},`]
-            : []),
-        `\t\tqueryTypeName: ${quoteTsString(options.queryTypeName)},`,
-        "\t\trestManifest: defineEndpointManifest(",
-        indentMultiline(JSON.stringify(manifest, null, "\t"), "\t\t\t"),
-        "\t\t),",
-        `\t\tresponseTypeName: ${quoteTsString(options.responseTypeName)},`,
-        ...(options.secretFieldName
-            ? [`\t\tsecretFieldName: ${quoteTsString(options.secretFieldName)},`]
-            : []),
-        ...(options.secretPreserveOnEmpty !== undefined
-            ? [`\t\tsecretPreserveOnEmpty: ${options.secretPreserveOnEmpty},`]
-            : []),
-        ...(options.secretStateFieldName
-            ? [`\t\tsecretStateFieldName: ${quoteTsString(options.secretStateFieldName)},`]
-            : []),
-        `\t\tslug: ${quoteTsString(options.restResourceSlug)},`,
-        `\t\ttypesFile: ${quoteTsString(`src/rest/${options.restResourceSlug}/api-types.ts`)},`,
-        `\t\tvalidatorsFile: ${quoteTsString(`src/rest/${options.restResourceSlug}/api-validators.ts`)},`,
-        "\t},",
-    ].join("\n");
-}
-/**
- * Build the editable TypeScript type source for a manual REST contract.
- *
- * @param options Manual contract type naming metadata.
- * @param options.bodyTypeName Optional exported body type name.
- * @param options.pathParameterNames Route named captures that should be present
- * in the starter query type so generated clients can fill provider paths.
- * @param options.queryTypeName Exported query type name.
- * @param options.responseTypeName Exported response type name.
- * @param options.restResourceSlug Normalized workspace REST contract slug.
- * @param options.secretFieldName Optional raw secret field included only in the request body.
- * @param options.secretStateFieldName Optional masked response boolean field.
- * @returns TypeScript source for `api-types.ts`.
- */
-export function buildManualRestContractTypesSource(options) {
-    const title = toTitleCase(options.restResourceSlug);
-    const pathParameterNames = Array.from(new Set(options.pathParameterNames ?? []));
-    const queryFields = pathParameterNames.length > 0
-        ? pathParameterNames.map((parameterName) => `\t${parameterName}: string & tags.MinLength< 1 >;`)
-        : ["\tid?: string & tags.MinLength< 1 >;"];
-    const lines = [
-        "import type { tags } from '@wp-typia/block-runtime/typia-tags';",
-        "",
-        `export interface ${options.queryTypeName} {`,
-        ...queryFields,
-        ...(pathParameterNames.includes("preview") ? [] : ["\tpreview?: boolean;"]),
-        "}",
-    ];
-    if (options.bodyTypeName) {
-        const secretPreserveOnEmpty = options.secretPreserveOnEmpty ?? true;
-        const secretLines = options.secretFieldName && options.secretStateFieldName
-            ? [
-                `\t${options.secretFieldName}?: string${secretPreserveOnEmpty ? " & tags.MinLength< 1 >" : ""} & tags.MaxLength< 4096 > & tags.Secret< ${quoteTsString(options.secretStateFieldName)} >${secretPreserveOnEmpty ? " & tags.PreserveOnEmpty< true >" : ""};`,
-                secretPreserveOnEmpty
-                    ? `\t// ${options.secretFieldName} is write-only: omit or submit an empty value to preserve the stored secret, and expose ${options.secretStateFieldName} in responses instead of returning the raw value.`
-                    : `\t// ${options.secretFieldName} is write-only: persist it server-side and expose ${options.secretStateFieldName} in responses instead of returning the raw value.`,
-            ]
-            : [];
-        lines.push("", `export interface ${options.bodyTypeName} {`, ...secretLines, "\tpayload: string & tags.MinLength< 1 >;", "\tcomment?: string & tags.MaxLength< 500 >;", "}");
-    }
-    lines.push("", `export interface ${options.responseTypeName} {`, ...(options.secretStateFieldName
-        ? [
-            `\t${options.secretStateFieldName}: boolean;`,
-            `\t// Raw secret fields such as ${options.secretFieldName ?? "the request secret"} must never be returned in this response.`,
-        ]
-        : []), "\tid: string & tags.MinLength< 1 >;", "\tstatus: 'ok' | 'error';", "\tmessage?: string;", "\tupdatedAt?: string;", "}", "", `// ${title} is a manual REST contract: edit these types to match the external route owner.`);
-    return `${lines.join("\n")}\n`;
-}
-/**
- * Build Typia validator source for a manual REST contract.
- *
- * @param options Manual contract type names to validate.
- * @param options.bodyTypeName Optional exported body type name.
- * @param options.queryTypeName Exported query type name.
- * @param options.responseTypeName Exported response type name.
- * @returns TypeScript source for `api-validators.ts`.
- */
-export function buildManualRestContractValidatorsSource(options) {
-    const importedTypes = [
-        options.queryTypeName,
-        ...(options.bodyTypeName ? [options.bodyTypeName] : []),
-        options.responseTypeName,
-    ].sort();
-    const validatorDeclarations = [
-        `const validateQuery = typia.createValidate< ${options.queryTypeName} >();`,
-        ...(options.bodyTypeName
-            ? [`const validateRequest = typia.createValidate< ${options.bodyTypeName} >();`]
-            : []),
-        `const validateResponse = typia.createValidate< ${options.responseTypeName} >();`,
-    ];
-    const validatorEntries = [
-        `\tquery: ( input: unknown ) => toValidationResult< ${options.queryTypeName} >( validateQuery( input ) ),`,
-        ...(options.bodyTypeName
-            ? [
-                `\trequest: ( input: unknown ) => toValidationResult< ${options.bodyTypeName} >( validateRequest( input ) ),`,
-            ]
-            : []),
-        `\tresponse: ( input: unknown ) => toValidationResult< ${options.responseTypeName} >( validateResponse( input ) ),`,
-    ];
-    return `import typia from 'typia';
-
-import { toValidationResult } from '@wp-typia/rest';
-import type {
-\t${importedTypes.join(",\n\t")},
-} from './api-types';
-
-${validatorDeclarations.join("\n")}
-
-export const apiValidators = {
-${validatorEntries.join("\n")}
-};
-`;
-}
-/**
- * Build the public API shim for a manual REST contract.
- *
- * @param options Manual REST contract operation and request type metadata.
- * @returns TypeScript source that re-exports the generated endpoint client.
- */
-export function buildManualRestContractApiSource(options) {
-    const pascalCase = toPascalCase(options.restResourceSlug);
-    const operationId = `call${pascalCase}ManualRestContract`;
-    const requestTypeName = options.bodyTypeName
-        ? `${pascalCase}ManualRestContractRequest`
-        : options.queryTypeName;
-    const requestTypeSource = options.bodyTypeName
-        ? `export interface ${requestTypeName} {
-\tbody: ${options.bodyTypeName};
-\tquery: ${options.queryTypeName};
-}
-
-`
-        : "";
-    const typeImports = options.bodyTypeName
-        ? [options.bodyTypeName, options.queryTypeName]
-        : [options.queryTypeName];
-    return `import {
-\tcallEndpoint,
-\tresolveRestRouteUrl,
-} from '@wp-typia/rest';
-
-import type {
-\t${typeImports.sort().join(",\n\t")},
-} from './api-types';
-import { ${operationId}Endpoint } from './api-client';
-
-export * from './api-client';
-
-${requestTypeSource}function resolveRestNonce(fallback?: string): string | undefined {
-\tif (typeof fallback === 'string' && fallback.length > 0) {
-\t\treturn fallback;
-\t}
-
-\tif (typeof window === 'undefined') {
-\t\treturn undefined;
-\t}
-
-\tconst wpApiSettings = (
-\t\twindow as typeof window & {
-\t\t\twpApiSettings?: { nonce?: string };
-\t\t}
-\t).wpApiSettings;
-
-\treturn typeof wpApiSettings?.nonce === 'string' &&
-\t\twpApiSettings.nonce.length > 0
-\t\t? wpApiSettings.nonce
-\t\t: undefined;
-}
-
-function resolveEndpointRouteOptions(request: ${requestTypeName}) {
-\tconst requestOptions = ${operationId}Endpoint.buildRequestOptions?.(request) ?? {};
-\tconst nonce = resolveRestNonce();
-\tconst requestHeaders = (
-\t\trequestOptions as { headers?: Record<string, string> }
-\t).headers;
-
-\treturn {
-\t\t...requestOptions,
-\t\theaders: nonce
-\t\t\t? {
-\t\t\t\t\t...(requestHeaders ?? {}),
-\t\t\t\t\t'X-WP-Nonce': nonce,
-\t\t\t\t}
-\t\t\t: requestHeaders,
-\t\tpath: undefined,
-\t\turl:
-\t\t\trequestOptions.url ??
-\t\t\tresolveRestRouteUrl(requestOptions.path ?? ${operationId}Endpoint.path),
-\t};
-}
-
-export const manualRestContractEndpoint = {
-\t...${operationId}Endpoint,
-\tbuildRequestOptions: resolveEndpointRouteOptions,
-};
-
-export function callManualRestContract(request: ${requestTypeName}) {
-\treturn callEndpoint(manualRestContractEndpoint, request);
-}
-`;
-}
-export function buildRestResourceTypesSource(restResourceSlug, methods) {
-    const pascalCase = toPascalCase(restResourceSlug);
-    const lines = [
-        "import { tags } from 'typia';",
-        "",
-        `export type ${pascalCase}Status = 'draft' | 'published';`,
-        "",
-        `export interface ${pascalCase}Record {`,
-        "\tid: number & tags.Type< 'uint32' >;",
-        "\ttitle: string & tags.MinLength< 1 > & tags.MaxLength< 120 >;",
-        "\tcontent?: string & tags.MaxLength< 2000 >;",
-        `\tstatus: ${pascalCase}Status;`,
-        "\tupdatedAt: string;",
-        "}",
-    ];
-    if (methods.includes("list")) {
-        lines.push("", `export interface ${pascalCase}ListQuery {`, "\tpage?: number & tags.Type< 'uint32' > & tags.Minimum< 1 > & tags.Default< 1 >;", "\tperPage?: number & tags.Type< 'uint32' > & tags.Minimum< 1 > & tags.Maximum< 50 > & tags.Default< 10 >;", "\tsearch?: string & tags.MaxLength< 120 >;", "}", "", `export interface ${pascalCase}ListResponse {`, `\titems: ${pascalCase}Record[];`, "\tpage: number & tags.Type< 'uint32' >;", "\tperPage: number & tags.Type< 'uint32' >;", "\ttotal: number & tags.Type< 'uint32' >;", "}");
-    }
-    if (methods.includes("read")) {
-        lines.push("", `export interface ${pascalCase}ReadQuery {`, "\tid: number & tags.Type< 'uint32' >;", "}", "", `export type ${pascalCase}ReadResponse = ${pascalCase}Record;`);
-    }
-    if (methods.includes("create")) {
-        lines.push("", `export interface ${pascalCase}CreateRequest {`, "\ttitle: string & tags.MinLength< 1 > & tags.MaxLength< 120 >;", "\tcontent?: string & tags.MaxLength< 2000 >;", `\tstatus?: ${pascalCase}Status;`, "}", "", `export type ${pascalCase}CreateResponse = ${pascalCase}Record;`);
-    }
-    if (methods.includes("update")) {
-        lines.push("", `export interface ${pascalCase}UpdateQuery {`, "\tid: number & tags.Type< 'uint32' >;", "}", "", `export interface ${pascalCase}UpdateRequest {`, "\ttitle?: string & tags.MinLength< 1 > & tags.MaxLength< 120 >;", "\tcontent?: string & tags.MaxLength< 2000 >;", `\tstatus?: ${pascalCase}Status;`, "}", "", `export type ${pascalCase}UpdateResponse = ${pascalCase}Record;`);
-    }
-    if (methods.includes("delete")) {
-        lines.push("", `export interface ${pascalCase}DeleteQuery {`, "\tid: number & tags.Type< 'uint32' >;", "}", "", `export interface ${pascalCase}DeleteResponse {`, "\tdeleted: true;", "\tid: number & tags.Type< 'uint32' >;", "}");
-    }
-    return `${lines.join("\n")}\n`;
-}
-export function buildRestResourceValidatorsSource(restResourceSlug, methods) {
-    const pascalCase = toPascalCase(restResourceSlug);
-    const importedTypes = new Set();
-    const validatorDeclarations = [];
-    const validatorEntries = [];
-    const addValidator = (propertyName, typeName, validateIdentifier) => {
-        importedTypes.add(typeName);
-        validatorDeclarations.push(`const ${validateIdentifier} = typia.createValidate< ${typeName} >();`);
-        validatorEntries.push(`\t${propertyName}: ( input: unknown ) => toValidationResult< ${typeName} >( ${validateIdentifier}( input ) ),`);
-    };
-    if (methods.includes("list")) {
-        addValidator("listQuery", `${pascalCase}ListQuery`, "validateListQuery");
-        addValidator("listResponse", `${pascalCase}ListResponse`, "validateListResponse");
-    }
-    if (methods.includes("read")) {
-        addValidator("readQuery", `${pascalCase}ReadQuery`, "validateReadQuery");
-        addValidator("readResponse", `${pascalCase}ReadResponse`, "validateReadResponse");
-    }
-    if (methods.includes("create")) {
-        addValidator("createRequest", `${pascalCase}CreateRequest`, "validateCreateRequest");
-        addValidator("createResponse", `${pascalCase}CreateResponse`, "validateCreateResponse");
-    }
-    if (methods.includes("update")) {
-        addValidator("updateQuery", `${pascalCase}UpdateQuery`, "validateUpdateQuery");
-        addValidator("updateRequest", `${pascalCase}UpdateRequest`, "validateUpdateRequest");
-        addValidator("updateResponse", `${pascalCase}UpdateResponse`, "validateUpdateResponse");
-    }
-    if (methods.includes("delete")) {
-        addValidator("deleteQuery", `${pascalCase}DeleteQuery`, "validateDeleteQuery");
-        addValidator("deleteResponse", `${pascalCase}DeleteResponse`, "validateDeleteResponse");
-    }
-    return `import typia from 'typia';
-
-import { toValidationResult } from '@wp-typia/rest';
-import type {
-\t${Array.from(importedTypes).sort().join(",\n\t")},
-} from './api-types';
-
-${validatorDeclarations.join("\n")}
-
-export const apiValidators = {
-${validatorEntries.join("\n")}
-};
-`;
-}
-export function buildRestResourceApiSource(restResourceSlug, methods) {
-    const pascalCase = toPascalCase(restResourceSlug);
-    const typeImports = new Set();
-    const clientEndpointImports = [];
-    const exportedBindings = [];
-    const writeMethods = methods.filter((method) => ["create", "update", "delete"].includes(method));
-    if (methods.includes("list")) {
-        typeImports.add(`${pascalCase}ListQuery`);
-        clientEndpointImports.push(`list${pascalCase}ResourcesEndpoint`);
-        exportedBindings.push(`export const restResourceListEndpoint = {
-\t...list${pascalCase}ResourcesEndpoint,
-\tbuildRequestOptions: ( request: ${pascalCase}ListQuery ) =>
-\t\tresolveEndpointRouteOptions( list${pascalCase}ResourcesEndpoint, request ),
-};
-
-export function listResource( request: ${pascalCase}ListQuery ) {
-\treturn callEndpoint( restResourceListEndpoint, request );
-}`);
-    }
-    if (methods.includes("read")) {
-        typeImports.add(`${pascalCase}ReadQuery`);
-        clientEndpointImports.push(`read${pascalCase}ResourceEndpoint`);
-        exportedBindings.push(`export const restResourceReadEndpoint = {
-\t...read${pascalCase}ResourceEndpoint,
-\tbuildRequestOptions: ( request: ${pascalCase}ReadQuery ) =>
-\t\tresolveEndpointRouteOptions( read${pascalCase}ResourceEndpoint, request ),
-};
-
-export function readResource( request: ${pascalCase}ReadQuery ) {
-\treturn callEndpoint( restResourceReadEndpoint, request );
-}`);
-    }
-    if (methods.includes("create")) {
-        typeImports.add(`${pascalCase}CreateRequest`);
-        clientEndpointImports.push(`create${pascalCase}ResourceEndpoint`);
-        exportedBindings.push(`export const restResourceCreateEndpoint = {
-\t...create${pascalCase}ResourceEndpoint,
-\tbuildRequestOptions: ( request: ${pascalCase}CreateRequest ) => {
-\t\tconst nonce = resolveRestNonce();
-\t\treturn {
-\t\t\t...resolveEndpointRouteOptions( create${pascalCase}ResourceEndpoint, request ),
-\t\t\theaders: nonce
-\t\t\t\t? {
-\t\t\t\t\t'X-WP-Nonce': nonce,
-\t\t\t\t}
-\t\t\t\t: undefined,
-\t\t};
-\t},
-};
-
-export function createResource( request: ${pascalCase}CreateRequest ) {
-\treturn callEndpoint( restResourceCreateEndpoint, request );
-}`);
-    }
-    if (methods.includes("update")) {
-        typeImports.add(`${pascalCase}UpdateQuery`);
-        typeImports.add(`${pascalCase}UpdateRequest`);
-        clientEndpointImports.push(`update${pascalCase}ResourceEndpoint`);
-        exportedBindings.push(`export const restResourceUpdateEndpoint = {
-\t...update${pascalCase}ResourceEndpoint,
-\tbuildRequestOptions: ( request: {
-\t\tbody: ${pascalCase}UpdateRequest;
-\t\tquery: ${pascalCase}UpdateQuery;
-\t} ) => {
-\t\tconst nonce = resolveRestNonce();
-\t\treturn {
-\t\t\t...resolveEndpointRouteOptions( update${pascalCase}ResourceEndpoint, request ),
-\t\t\theaders: nonce
-\t\t\t\t? {
-\t\t\t\t\t'X-WP-Nonce': nonce,
-\t\t\t\t}
-\t\t\t\t: undefined,
-\t\t};
-\t},
-};
-
-export function updateResource( request: {
-\tbody: ${pascalCase}UpdateRequest;
-\tquery: ${pascalCase}UpdateQuery;
-} ) {
-\treturn callEndpoint( restResourceUpdateEndpoint, request );
-}`);
-    }
-    if (methods.includes("delete")) {
-        typeImports.add(`${pascalCase}DeleteQuery`);
-        clientEndpointImports.push(`delete${pascalCase}ResourceEndpoint`);
-        exportedBindings.push(`export const restResourceDeleteEndpoint = {
-\t...delete${pascalCase}ResourceEndpoint,
-\tbuildRequestOptions: ( request: ${pascalCase}DeleteQuery ) => {
-\t\tconst nonce = resolveRestNonce();
-\t\treturn {
-\t\t\t...resolveEndpointRouteOptions( delete${pascalCase}ResourceEndpoint, request ),
-\t\t\theaders: nonce
-\t\t\t\t? {
-\t\t\t\t\t'X-WP-Nonce': nonce,
-\t\t\t\t}
-\t\t\t\t: undefined,
-\t\t};
-\t},
-};
-
-export function deleteResource( request: ${pascalCase}DeleteQuery ) {
-\treturn callEndpoint( restResourceDeleteEndpoint, request );
-}`);
-    }
-    const resolveRestNonceSource = writeMethods.length > 0
-        ? `function resolveRestNonce( fallback?: string ): string | undefined {
-\tif ( typeof fallback === 'string' && fallback.length > 0 ) {
-\t\treturn fallback;
-\t}
-
-\tif ( typeof window === 'undefined' ) {
-\t\treturn undefined;
-\t}
-
-\tconst wpApiSettings = (
-\t\twindow as typeof window & {
-\t\t\twpApiSettings?: { nonce?: string };
-\t\t}
-\t).wpApiSettings;
-
-\treturn typeof wpApiSettings?.nonce === 'string' &&
-\t\twpApiSettings.nonce.length > 0
-\t\t? wpApiSettings.nonce
-\t\t: undefined;
-}
-
-`
-        : "";
-    return `import {
-\tcallEndpoint,
-\tresolveRestRouteUrl,
-} from '@wp-typia/rest';
-
-import type {
-\t${Array.from(typeImports).sort().join(",\n\t")},
-} from './api-types';
-import {
-\t${clientEndpointImports.sort().join(",\n\t")},
-} from './api-client';
-${resolveRestNonceSource}
-function resolveEndpointRouteOptions<TRequest>(
-\tendpoint: {
-\t\tbuildRequestOptions?: ( request: TRequest ) => {
-\t\t\tpath?: string;
-\t\t\turl?: string;
-\t\t};
-\t\tpath: string;
-\t},
-\trequest: TRequest
-) {
-\tconst requestOptions = endpoint.buildRequestOptions?.( request ) ?? {};
-\treturn {
-\t\t...requestOptions,
-\t\tpath: undefined,
-\t\turl: requestOptions.url ?? resolveRestRouteUrl( requestOptions.path ?? endpoint.path ),
-\t};
-}
-
-${exportedBindings.join("\n\n")}
-`;
-}
-export function buildRestResourceDataSource(restResourceSlug, methods) {
-    const pascalCase = toPascalCase(restResourceSlug);
-    const typeImports = new Set();
-    const endpointImports = [];
-    const exportedBindings = [];
-    if (methods.includes("list")) {
-        typeImports.add(`${pascalCase}ListQuery`);
-        typeImports.add(`${pascalCase}ListResponse`);
-        endpointImports.push("restResourceListEndpoint");
-        exportedBindings.push(`export type Use${pascalCase}ListQueryOptions<
-\tSelected = ${pascalCase}ListResponse,
-> = UseEndpointQueryOptions<
-\t${pascalCase}ListQuery,
-\t${pascalCase}ListResponse,
-\tSelected
->;
-
-export function use${pascalCase}ListQuery<
-\tSelected = ${pascalCase}ListResponse,
->(
-\trequest: ${pascalCase}ListQuery,
-\toptions: Use${pascalCase}ListQueryOptions< Selected > = {}
-) {
-\treturn useEndpointQuery( restResourceListEndpoint, request, options );
-}`);
-    }
-    if (methods.includes("read")) {
-        typeImports.add(`${pascalCase}ReadQuery`);
-        typeImports.add(`${pascalCase}ReadResponse`);
-        endpointImports.push("restResourceReadEndpoint");
-        exportedBindings.push(`export type Use${pascalCase}ReadQueryOptions<
-\tSelected = ${pascalCase}ReadResponse,
-> = UseEndpointQueryOptions<
-\t${pascalCase}ReadQuery,
-\t${pascalCase}ReadResponse,
-\tSelected
->;
-
-export function use${pascalCase}ReadQuery<
-\tSelected = ${pascalCase}ReadResponse,
->(
-\trequest: ${pascalCase}ReadQuery,
-\toptions: Use${pascalCase}ReadQueryOptions< Selected > = {}
-) {
-\treturn useEndpointQuery( restResourceReadEndpoint, request, options );
-}`);
-    }
-    if (methods.includes("create")) {
-        typeImports.add(`${pascalCase}CreateRequest`);
-        typeImports.add(`${pascalCase}CreateResponse`);
-        endpointImports.push("restResourceCreateEndpoint");
-        exportedBindings.push(`export type UseCreate${pascalCase}ResourceMutationOptions = UseEndpointMutationOptions<
-\t${pascalCase}CreateRequest,
-\t${pascalCase}CreateResponse,
-\tunknown
->;
-
-export function useCreate${pascalCase}ResourceMutation(
-\toptions: UseCreate${pascalCase}ResourceMutationOptions = {}
-) {
-\treturn useEndpointMutation( restResourceCreateEndpoint, options );
-}`);
-    }
-    if (methods.includes("update")) {
-        typeImports.add(`${pascalCase}UpdateQuery`);
-        typeImports.add(`${pascalCase}UpdateRequest`);
-        typeImports.add(`${pascalCase}UpdateResponse`);
-        endpointImports.push("restResourceUpdateEndpoint");
-        exportedBindings.push(`export type UseUpdate${pascalCase}ResourceMutationOptions = UseEndpointMutationOptions<
-\t{
-\t\tbody: ${pascalCase}UpdateRequest;
-\t\tquery: ${pascalCase}UpdateQuery;
-\t},
-\t${pascalCase}UpdateResponse,
-\tunknown
->;
-
-export function useUpdate${pascalCase}ResourceMutation(
-\toptions: UseUpdate${pascalCase}ResourceMutationOptions = {}
-) {
-\treturn useEndpointMutation( restResourceUpdateEndpoint, options );
-}`);
-    }
-    if (methods.includes("delete")) {
-        typeImports.add(`${pascalCase}DeleteQuery`);
-        typeImports.add(`${pascalCase}DeleteResponse`);
-        endpointImports.push("restResourceDeleteEndpoint");
-        exportedBindings.push(`export type UseDelete${pascalCase}ResourceMutationOptions = UseEndpointMutationOptions<
-\t${pascalCase}DeleteQuery,
-\t${pascalCase}DeleteResponse,
-\tunknown
->;
-
-export function useDelete${pascalCase}ResourceMutation(
-\toptions: UseDelete${pascalCase}ResourceMutationOptions = {}
-) {
-\treturn useEndpointMutation( restResourceDeleteEndpoint, options );
-}`);
-    }
-    return `import {
-\tuseEndpointMutation,
-\tuseEndpointQuery,
-\ttype UseEndpointMutationOptions,
-\ttype UseEndpointQueryOptions,
-} from '@wp-typia/rest/react';
-
-import type {
-\t${Array.from(typeImports).sort().join(",\n\t")},
-} from './api-types';
-import {
-\t${endpointImports.sort().join(",\n\t")},
-} from './api';
-
-${exportedBindings.join("\n\n")}
-`;
-}
+export { buildRestResourceApiSource, buildRestResourceConfigEntry, buildRestResourceDataSource, buildRestResourceTypesSource, buildRestResourceValidatorsSource, } from "./cli-add-workspace-rest-generated-source-emitters.js";
+export { buildManualRestContractApiSource, buildManualRestContractConfigEntry, buildManualRestContractTypesSource, buildManualRestContractValidatorsSource, } from "./cli-add-workspace-rest-manual-source-emitters.js";

package/dist/runtime/cli-add-workspace-rest-source-utils.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Prefix every line in a multi-line source fragment.
+ *
+ * @param source Source fragment to indent.
+ * @param prefix Prefix to prepend to every line.
+ * @returns The source fragment with each line prefixed.
+ */
+export declare function indentMultiline(source: string, prefix: string): string;
+/**
+ * Render the shared REST nonce helper in the formatting style expected by a
+ * generated source file.
+ *
+ * @param style Compact output is used by manual-contract shims; spaced output
+ * matches generated REST resource shims.
+ * @returns TypeScript source for the embedded `resolveRestNonce()` helper.
+ */
+export declare function formatResolveRestNonceSource(style: "compact" | "spaced"): string;